<!DOCTYPE html>
<html class="client-nojs vector-feature-night-mode-disabled vector-feature-language-in-header-enabled vector-feature-language-in-main-page-header-disabled vector-feature-page-tools-pinned-disabled vector-feature-toc-pinned-clientpref-1 vector-feature-main-menu-pinned-disabled vector-feature-limited-width-clientpref-1 vector-feature-limited-width-content-enabled vector-feature-custom-font-size-clientpref-1 vector-feature-appearance-pinned-clientpref-1 vector-sticky-header-enabled" lang="en" dir="ltr"><head>
<meta charset="UTF-8">
<title>JavaScript syntax</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link rel="canonical" href="https://en.wikipedia.org/wiki/JavaScript_syntax"> <link href="./mw/ext.cite.styles.css" rel="stylesheet" type="text/css">
<link href="./mw/ext.math.styles.css" rel="stylesheet" type="text/css">
<link href="./mw/ext.pygments.css" rel="stylesheet" type="text/css">
<link href="./mw/skins.vector.icons.css" rel="stylesheet" type="text/css">
<link href="./mw/skins.vector.search.codex.styles.css" rel="stylesheet" type="text/css">
<link href="./mw/skins.vector.styles.css" rel="stylesheet" type="text/css">
<link href="./mw/user.styles.css" rel="stylesheet" type="text/css">
<meta name="ResourceLoaderDynamicStyles" content="">
<link rel="stylesheet" type="text/css" href="./mw/site.styles.css">
<link rel="stylesheet" type="text/css" href="./mw/noscript.css">
<link rel="stylesheet" type="text/css" href="./footer.css">
<link rel="stylesheet" type="text/css" href="./vector-2022.css">
</head>
<body class="skin--responsive skin-vector skin-vector-search-vue mediawiki ltr sitedir-ltr mw-hide-empty-elt ns-0 ns-subject page-JavaScript_syntax rootpage-JavaScript_syntax skin-vector-2022 action-view">
<div class="mw-page-container">
<div class="mw-page-container-inner">
<div class="mw-content-container">
<main id="content" class="mw-body">
<header class="mw-body-header vector-page-titlebar">
<h1 id="firstHeading" class="firstHeading mw-first-heading">
<span id="openzim-page-title" class="mw-page-title-main"><span class="mw-page-title-main">JavaScript syntax</span></span>
</h1>
</header>
<a id="top"></a>
<div id="bodyContent" class="vector-body ve-init-mw-desktopArticleTarget-targetContainer" aria-labelledby="firstHeading" data-mw-ve-target-container="">
<div id="mw-content-text" class="mw-body-content mw-content-ltr" lang="en" dir="ltr"><div class="mw-content-ltr mw-parser-output" lang="en" dir="ltr">
<style data-mw-deduplicate="TemplateStyles:r1305433154">
/* start https://en.wikipedia.org/ */
.mw-parser-output .ambox{border:1px solid #a2a9b1;border-left:10px solid #36c;background-color:#fbfbfb;box-sizing:border-box}.mw-parser-output .ambox+link+.ambox,.mw-parser-output .ambox+link+style+.ambox,.mw-parser-output .ambox+link+link+.ambox,.mw-parser-output .ambox+.mw-empty-elt+link+.ambox,.mw-parser-output .ambox+.mw-empty-elt+link+style+.ambox,.mw-parser-output .ambox+.mw-empty-elt+link+link+.ambox{margin-top:-1px}html body.mediawiki .mw-parser-output .ambox.mbox-small-left{margin:4px 1em 4px 0;overflow:hidden;width:238px;border-collapse:collapse;font-size:88%;line-height:1.25em}.mw-parser-output .ambox-speedy{border-left:10px solid #b32424;background-color:#fee7e6}.mw-parser-output .ambox-delete{border-left:10px solid #b32424}.mw-parser-output .ambox-content{border-left:10px solid #f28500}.mw-parser-output .ambox-style{border-left:10px solid #fc3}.mw-parser-output .ambox-move{border-left:10px solid #9932cc}.mw-parser-output .ambox-protection{border-left:10px solid #a2a9b1}.mw-parser-output .ambox .mbox-text{border:none;padding:0.25em 0.5em;width:100%}.mw-parser-output .ambox .mbox-image{border:none;padding:2px 0 2px 0.5em;text-align:center}.mw-parser-output .ambox .mbox-imageright{border:none;padding:2px 0.5em 2px 0;text-align:center}.mw-parser-output .ambox .mbox-empty-cell{border:none;padding:0;width:1px}.mw-parser-output .ambox .mbox-image-div{width:52px}@media(min-width:720px){.mw-parser-output .ambox{margin:0 10%}}@media print{body.ns-0 .mw-parser-output .ambox{display:none!important}}
/* end https://en.wikipedia.org/ */
</style>
<p class="mw-empty-elt">
</p>
<p>The <b><a href="Syntax_(programming_languages)" title="Syntax (programming languages)">syntax</a> of <a href="JavaScript" title="JavaScript">JavaScript</a></b> is the set of rules that define a correctly structured JavaScript program.
</p><p>The examples below make use of the <code>console.log()</code> function present in most browsers for <a href="Standard_streams#Standard_output_.28stdout.29" title="Standard streams">standard text output</a>.
</p><p>The JavaScript <a href="Standard_library" title="Standard library">standard library</a> lacks an official standard text output function (with the exception of <code>document.write</code>). Given that JavaScript is mainly used for <a href="Client-side_scripting" class="mw-redirect" title="Client-side scripting">client-side scripting</a> within modern <a href="Web_browser" title="Web browser">web browsers</a>, and that almost all Web browsers provide the alert function, <code>alert</code> can also be used, but is not commonly used.
</p>
<meta property="mw:PageProp/toc">
<div class="mw-heading mw-heading2"><h2 id="Origins">Origins</h2></div>
<p><a href="Brendan_Eich" title="Brendan Eich">Brendan Eich</a> summarized the ancestry of the syntax in the first paragraph of the JavaScript 1.1 specification<sup id="cite_ref-1" class="reference"><a href="#cite_note-1"><span class="cite-bracket">[</span>1<span class="cite-bracket">]</span></a></sup><sup id="cite_ref-2" class="reference"><a href="#cite_note-2"><span class="cite-bracket">[</span>2<span class="cite-bracket">]</span></a></sup> as follows:
</p>
<style data-mw-deduplicate="TemplateStyles:r1244412712">
/* start https://en.wikipedia.org/ */
.mw-parser-output .templatequote{overflow:hidden;margin:1em 0;padding:0 32px}.mw-parser-output .templatequotecite{line-height:1.5em;text-align:left;margin-top:0}@media(min-width:500px){.mw-parser-output .templatequotecite{padding-left:1.6em}}
/* end https://en.wikipedia.org/ */
</style><blockquote class="templatequote"><p>JavaScript borrows most of its syntax from <a href="Java_(programming_language)" title="Java (programming language)">Java</a>, but also inherits from <a href="Awk" class="mw-redirect" title="Awk">Awk</a> and <a href="Perl" title="Perl">Perl</a>, with some indirect influence from <a href="Self_(programming_language)" title="Self (programming language)">Self</a> in its object prototype system.</p></blockquote>
<div class="mw-heading mw-heading2"><h2 id="Basics">Basics</h2></div>
<div class="mw-heading mw-heading3"><h3 id="Case_sensitivity">Case sensitivity</h3></div>
<p>JavaScript is <a href="Case_sensitivity" title="Case sensitivity">case sensitive</a>. It is common to start the name of a <a href="#Constructors">constructor</a> with a <a href="CamelCase" class="mw-redirect" title="CamelCase">capitalized</a> letter, and the name of a function or variable with a lower-case letter.
</p><p>Example:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">var</span><span class="w"> </span><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">5</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">a</span><span class="p">);</span><span class="w"> </span><span class="c1">// 5</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">A</span><span class="p">);</span><span class="w"> </span><span class="c1">// throws a ReferenceError: A is not defined</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Whitespace_and_semicolons">Whitespace and semicolons</h3></div>
<p>Unlike in <a href="C_(programming_language)" title="C (programming language)">C</a>, whitespace in JavaScript source can directly impact <a href="Semantics_(computer_science)" title="Semantics (computer science)">semantics</a>. <a href="Semicolon" title="Semicolon">Semicolons</a> end statements in JavaScript. Because of <a href="Lexical_analysis#Semicolon_insertion" title="Lexical analysis">automatic semicolon insertion</a> (ASI), some statements that are well formed when a newline is <a href="Parsing" title="Parsing">parsed</a> will be considered complete, as if a semicolon were inserted just prior to the newline. Some authorities advise supplying statement-terminating semicolons explicitly, because it may lessen unintended effects of the automatic semicolon insertion.<sup id="cite_ref-3" class="reference"><a href="#cite_note-3"><span class="cite-bracket">[</span>3<span class="cite-bracket">]</span></a></sup>
</p><p>There are two issues: five tokens can either begin a statement or be the extension of a complete statement; and five restricted productions, where line breaks are not allowed in certain positions, potentially yielding incorrect parsing.
</p><p>The five problematic tokens are the open parenthesis "<code>(</code>", open bracket "<code>[</code>", slash "<code>/</code>", plus "<code>+</code>", and minus "<code>-</code>". Of these, the open parenthesis is common in the <a href="Immediately_invoked_function_expression" title="Immediately invoked function expression">immediately invoked function expression</a> pattern, and open bracket occurs sometimes, while others are quite rare. An example:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">c</span>
<span class="p">(</span><span class="nx">d</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">e</span><span class="p">).</span><span class="nx">foo</span><span class="p">()</span>
<span class="c1">// Treated as:</span>
<span class="c1">// a = b + c(d + e).foo();</span>
</pre></div>
<p>with the suggestion that the preceding statement be terminated with a semicolon.
</p><p>Some suggest instead the use of <i>leading</i> semicolons on lines starting with '<code>(</code>' or '<code>[</code>', so the line is not accidentally joined with the previous one. This is known as a <b>defensive semicolon</b>, and is particularly recommended, because code may otherwise become ambiguous when it is rearranged. For example:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">c</span>
<span class="p">;(</span><span class="nx">d</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">e</span><span class="p">).</span><span class="nx">foo</span><span class="p">()</span>
<span class="c1">// Treated as:</span>
<span class="c1">// a = b + c;</span>
<span class="c1">// (d + e).foo();</span>
</pre></div>
<p>Initial semicolons are also sometimes used at the start of JavaScript libraries, in case they are appended to another library that omits a trailing semicolon, as this can result in ambiguity of the initial statement.
</p><p>The five restricted productions are <code>return</code>, <code>throw</code>, <code>break</code>, <code>continue</code>, and post-increment/decrement. In all cases, inserting semicolons does not fix the problem, but makes the parsed syntax clear, making the error easier to detect. <code>return</code> and <code>throw</code> take an optional value, while <code>break</code> and <code>continue</code> take an optional label. In all cases, the advice is to keep the value or label on the same line as the statement. This most often shows up in the return statement, where one might return a large object literal, which might be accidentally placed starting on a new line. For post-increment/decrement, there is potential ambiguity with pre-increment/decrement, and again it is recommended to simply keep these on the same line.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">return</span>
<span class="nx">a</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">b</span><span class="p">;</span>
<span class="c1">// Returns undefined. Treated as:</span>
<span class="c1">// return;</span>
<span class="c1">// a + b;</span>
<span class="c1">// Should be written as:</span>
<span class="c1">// return a + b;</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Comments">Comments</h3></div>
<p><a href="Comment_(computer_programming)" title="Comment (computer programming)">Comment</a> syntax is the same as in <a href="C%2B%2B" title="C++">C++</a>, <a href="Swift_(programming_language)" title="Swift (programming language)">Swift</a> and other programming languages.
</p><p>Single-line comments begin with <code>//</code> and continue until the end of the line. A second type of comments can also be made; these start with <code>/*</code> and end with <code>*/</code> and can be used for multi-line comments.
</p><p>A third type of comment, the hashbang comment, starts with <code>#!</code> and continues until the end of the line. They are only valid at the start of files and are intended for use in <a href="Command-line_interface" title="Command-line interface">CLI</a> environments.<sup id="cite_ref-4" class="reference"><a href="#cite_note-4"><span class="cite-bracket">[</span>4<span class="cite-bracket">]</span></a></sup>
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="err">#</span><span class="o">!</span><span class="w"> </span><span class="nx">Hashbang</span><span class="w"> </span><span class="nx">comment</span>
<span class="c1">// One-line comment</span>
<span class="cm">/* Multi-line</span>
<span class="cm"> comment */</span>
</pre></div>
<div class="mw-heading mw-heading2"><h2 id="Variables">Variables</h2></div>
<style data-mw-deduplicate="TemplateStyles:r1236090951">
/* start https://en.wikipedia.org/ */
.mw-parser-output .hatnote{font-style:italic}.mw-parser-output div.hatnote{padding-left:1.6em;margin-bottom:0.5em}.mw-parser-output .hatnote i{font-style:normal}.mw-parser-output .hatnote+link+.hatnote{margin-top:-0.5em}@media print{body.ns-0 .mw-parser-output .hatnote{display:none!important}}
/* end https://en.wikipedia.org/ */
</style><div role="note" class="hatnote navigation-not-searchable">Main article: <a href="Variable_(programming)" class="mw-redirect" title="Variable (programming)">Variable (programming)</a></div>
<p><a href="Variable_(programming)" class="mw-redirect" title="Variable (programming)">Variables</a> in standard JavaScript have no <a href="Type_system" title="Type system">type</a> attached, so any value (each <i>value</i> has a type) can be stored in any variable. Starting with <a href="ECMAScript#6th_Edition_–_ECMAScript_2015" title="ECMAScript">ES6</a>, the 6th version of the language, variables could be declared with <code>var</code> for function scoped variables, and <code>let</code> or <code>const</code> which are for <a href="Block_scope" class="mw-redirect" title="Block scope">block level</a> variables. Before ES6, variables could only be declared with a <code>var</code> statement. Values assigned to variables declared with <code>const</code> cannot be changed, but their properties can. <code>var</code> should no longer be used since <code>let</code> and <code>const</code> are supported by modern browsers.<sup id="cite_ref-5" class="reference"><a href="#cite_note-5"><span class="cite-bracket">[</span>5<span class="cite-bracket">]</span></a></sup> A variable's <a href="Identifier_(computer_languages)" title="Identifier (computer languages)">identifier</a> must start with a letter, underscore (<code>_</code>), or dollar sign (<code>$</code>), while subsequent characters can also be digits (<code>0-9</code>). JavaScript is case sensitive, so the uppercase characters "A" through "Z" are different from the lowercase characters "a" through "z".
</p><p>Starting with JavaScript 1.5, <a href="ISO_8859-1" class="mw-redirect" title="ISO 8859-1">ISO 8859-1</a> or <a href="Unicode" title="Unicode">Unicode</a> letters (or <code>\uXXXX</code> Unicode escape sequences) can be used in identifiers.<sup id="cite_ref-6" class="reference"><a href="#cite_note-6"><span class="cite-bracket">[</span>6<span class="cite-bracket">]</span></a></sup> In certain JavaScript implementations, the at sign (@) can be used in an identifier, but this is contrary to the specifications and not supported in newer implementations.
</p>
<div class="mw-heading mw-heading3"><h3 id="Scoping_and_hoisting">Scoping and hoisting</h3></div>
<p>Variables declared with <code>var</code> are <a href="Lexical_scoping" class="mw-redirect" title="Lexical scoping">lexically scoped</a> at a <a href="Function_scope" class="mw-redirect" title="Function scope">function level</a>, while ones with <code>let</code> or <code>const</code> have a <a href="Block_scope" class="mw-redirect" title="Block scope">block level</a> scope. Since declarations are processed before any code is executed, a variable can be assigned to and used prior to being declared in the code.<sup id="cite_ref-7" class="reference"><a href="#cite_note-7"><span class="cite-bracket">[</span>7<span class="cite-bracket">]</span></a></sup> This is referred to as <i><style data-mw-deduplicate="TemplateStyles:r1238216509">
/* start https://en.wikipedia.org/ */
.mw-parser-output .vanchor>:target~.vanchor-text{background-color:#b1d2ff}@media screen{html.skin-theme-clientpref-night .mw-parser-output .vanchor>:target~.vanchor-text{background-color:#0f4dc9}}@media screen and (prefers-color-scheme:dark){html.skin-theme-clientpref-os .mw-parser-output .vanchor>:target~.vanchor-text{background-color:#0f4dc9}}
/* end https://en.wikipedia.org/ */
</style><span class="vanchor"><span class="vanchor-text">hoisting</span></span></i>, and it is equivalent to variables being <a href="Forward_declaration" title="Forward declaration">forward declared</a> at the top of the function or block.<sup id="cite_ref-8" class="reference"><a href="#cite_note-8"><span class="cite-bracket">[</span>8<span class="cite-bracket">]</span></a></sup>
</p><p>With <code>var</code>, <code>let</code>, and <code>const</code> statements, only the declaration is hoisted; assignments are not hoisted. Thus a <code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="kd">var</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">1</span></code> statement in the middle of the function is equivalent to a <code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="kd">var</span><span class="w"> </span><span class="nx">x</span></code> declaration statement at the top of the function, and an <code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">1</span></code> assignment statement at that point in the middle of the function. This means that values cannot be accessed before they are declared; <a href="Forward_reference" class="mw-redirect" title="Forward reference">forward reference</a> is not possible. With <code>var</code> a variable's value is <code>undefined</code> until it is initialized. Variables declared with <code>let</code> or <code>const</code> cannot be accessed until they have been initialized, so referencing such variables before will cause an error.
</p><p>Function declarations, which declare a variable and assign a function to it, are similar to variable statements, but in addition to hoisting the declaration, they also hoist the assignment – as if the entire statement appeared at the top of the containing function – and thus forward reference is also possible: the location of a function statement within an enclosing function is irrelevant. This is different from a function expression being assigned to a variable in a <code>var</code>, <code>let</code>, or <code>const</code> statement.
</p><p>So, for example,
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">var</span><span class="w"> </span><span class="nx">func</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">..</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="c1">// declaration is hoisted only</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">func</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">..</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="c1">// declaration and assignment are hoisted</span>
</pre></div>
<p>Block scoping can be produced by wrapping the entire block in a function and then executing it – this is known as the <a href="Immediately-invoked_function_expression" class="mw-redirect" title="Immediately-invoked function expression">immediately-invoked function expression</a> pattern – or by declaring the variable using the <code>let</code> keyword.
</p>
<div class="mw-heading mw-heading3"><h3 id="Declaration_and_assignment">Declaration and assignment</h3></div>
<p>Variables declared outside a scope are <a href="Global_variable" title="Global variable">global</a>. If a variable is declared in a higher scope, it can be accessed by child scopes.
</p><p>When JavaScript tries to <b>resolve</b> an identifier, it looks in the local scope. If this identifier is not found, it looks in the next outer scope, and so on along the <i>scope chain</i> until it reaches the <i>global scope</i> where global variables reside. If it is still not found, JavaScript will raise a <code>ReferenceError</code> exception.
</p><p>When <b>assigning</b> an identifier, JavaScript goes through exactly the same process to retrieve this identifier, except that if it is not found in the <i>global scope</i>, it will create the "variable" in the scope where it was created.<sup id="cite_ref-9" class="reference"><a href="#cite_note-9"><span class="cite-bracket">[</span>9<span class="cite-bracket">]</span></a></sup> As a consequence, a variable never declared will be global, if assigned. Declaring a variable (with the keyword <code>var</code>) in the <i>global scope</i> (i.e. outside of any function body (or block in the case of let/const)), assigning a never declared identifier or adding a property to the <i>global object</i> (usually <i>window</i>) will also create a new global variable.
</p><p>Note that JavaScript's <i>strict mode</i> forbids the assignment of an undeclared variable, which avoids global namespace pollution.
</p>
<div class="mw-heading mw-heading3"><h3 id="Examples">Examples</h3></div>
<p>Here are some examples of variable declarations and scope:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">var</span><span class="w"> </span><span class="nx">x1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">0</span><span class="p">;</span><span class="w"> </span><span class="c1">// A global variable, because it is not in any function</span>
<span class="kd">let</span><span class="w"> </span><span class="nx">x2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">0</span><span class="p">;</span><span class="w"> </span><span class="c1">// Also global, this time because it is not in any block</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">f</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kd">var</span><span class="w"> </span><span class="nx">z</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'foxes'</span><span class="p">,</span><span class="w"> </span><span class="nx">r</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'birds'</span><span class="p">;</span><span class="w"> </span><span class="c1">// 2 local variables</span>
<span class="w"> </span><span class="nx">m</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'fish'</span><span class="p">;</span><span class="w"> </span><span class="c1">// global, because it was not declared anywhere before</span>
<span class="w"> </span><span class="kd">function</span><span class="w"> </span><span class="nx">child</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kd">var</span><span class="w"> </span><span class="nx">r</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'monkeys'</span><span class="p">;</span><span class="w"> </span><span class="c1">// This variable is local and does not affect the "birds" r of the parent function.</span>
<span class="w"> </span><span class="nx">z</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'penguins'</span><span class="p">;</span><span class="w"> </span><span class="c1">// Closure: Child function is able to access the variables of the parent function.</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="nx">twenty</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">20</span><span class="p">;</span><span class="w"> </span><span class="c1">// This variable is declared on the next line, but usable anywhere in the function, even before, as here</span>
<span class="w"> </span><span class="kd">var</span><span class="w"> </span><span class="nx">twenty</span><span class="p">;</span>
<span class="w"> </span><span class="nx">child</span><span class="p">();</span>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">x1</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">x2</span><span class="p">;</span><span class="w"> </span><span class="c1">// We can use x1 and x2 here, because they are global</span>
<span class="p">}</span>
<span class="nx">f</span><span class="p">();</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">z</span><span class="p">);</span><span class="w"> </span><span class="c1">// This line will raise a ReferenceError exception, because the value of z is no longer available</span>
</pre></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kd">let</span><span class="w"> </span><span class="nx">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">0</span><span class="p">;</span><span class="w"> </span><span class="nx">i</span><span class="w"> </span><span class="o"><</span><span class="w"> </span><span class="mf">10</span><span class="p">;</span><span class="w"> </span><span class="nx">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">i</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">i</span><span class="p">);</span><span class="w"> </span><span class="c1">// throws a ReferenceError: i is not defined</span>
</pre></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kd">const</span><span class="w"> </span><span class="nx">i</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">0</span><span class="p">;</span><span class="w"> </span><span class="nx">i</span><span class="w"> </span><span class="o"><</span><span class="w"> </span><span class="mf">10</span><span class="p">;</span><span class="w"> </span><span class="nx">i</span><span class="o">++</span><span class="p">)</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">i</span><span class="p">);</span><span class="w"> </span><span class="c1">// throws a TypeError: Assignment to constant variable</span>
<span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kd">const</span><span class="w"> </span><span class="nx">i</span><span class="w"> </span><span class="k">of</span><span class="w"> </span><span class="p">[</span><span class="mf">1</span><span class="p">,</span><span class="mf">2</span><span class="p">,</span><span class="mf">3</span><span class="p">])</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">i</span><span class="p">);</span><span class="w"> </span><span class="c1">//will not raise an exception. i is not reassigned but recreated in every iteration</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">pi</span><span class="p">;</span><span class="w"> </span><span class="c1">// throws a SyntaxError: Missing initializer in const declaration</span>
</pre></div>
<div class="mw-heading mw-heading2"><h2 id="Primitive_data_types">Primitive data types</h2></div>
<div role="note" class="hatnote navigation-not-searchable">Main article: <a href="Primitive_data_type" title="Primitive data type">Primitive data type</a></div>
<p>The JavaScript language provides six <a href="Primitive_data_type" title="Primitive data type">primitive data types</a>:
</p>
<ul><li>Undefined</li>
<li>Number</li>
<li>BigInt</li>
<li>String</li>
<li>Boolean</li>
<li>Symbol</li></ul>
<p>Some of the primitive data types also provide a set of named values that represent the extents of the type boundaries. These named values are described within the appropriate sections below.
</p>
<div class="mw-heading mw-heading3"><h3 id="Undefined">Undefined</h3></div>
<div role="note" class="hatnote navigation-not-searchable">Main article: <a href="Undefined_value" title="Undefined value">Undefined value</a></div>
<p>The <a href="Undefined_value" title="Undefined value">value of "undefined"</a> is assigned to all <a href="Uninitialized_variable" title="Uninitialized variable">uninitialized variables</a>, and is also returned when checking for object properties that do not exist. In a Boolean context, the undefined value is considered a false value.
</p><p>Note: undefined is considered a genuine primitive type. Unless explicitly converted, the undefined value may behave unexpectedly in comparison to other types that evaluate to false in a logical context.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">let</span><span class="w"> </span><span class="nx">test</span><span class="p">;</span><span class="w"> </span><span class="c1">// variable declared, but not defined, ...</span>
<span class="w"> </span><span class="c1">// ... set to value of undefined</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">testObj</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{};</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">test</span><span class="p">);</span><span class="w"> </span><span class="c1">// test variable exists, but value not ...</span>
<span class="w"> </span><span class="c1">// ... defined, displays undefined</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">testObj</span><span class="p">.</span><span class="nx">myProp</span><span class="p">);</span><span class="w"> </span><span class="c1">// testObj exists, property does not, ...</span>
<span class="w"> </span><span class="c1">// ... displays undefined</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">undefined</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="kc">null</span><span class="p">);</span><span class="w"> </span><span class="c1">// unenforced type during check, displays true</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">undefined</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">null</span><span class="p">);</span><span class="w"> </span><span class="c1">// enforce type during check, displays false</span>
</pre></div>
<p>Note: There is no built-in language literal for undefined. Thus <code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="p">(</span><span class="nx">x</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">undefined</span><span class="p">)</span></code> is not a foolproof way to check whether a variable is undefined, because in versions before ECMAScript 5, it is legal for someone to write <code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="kd">var</span><span class="w"> </span><span class="kc">undefined</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"I'm defined now"</span><span class="p">;</span></code>. A more robust approach is to compare using <code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="p">(</span><span class="ow">typeof</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="s1">'undefined'</span><span class="p">)</span></code>.
</p><p>Functions like this will not work as expected:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">function</span><span class="w"> </span><span class="nx">isUndefined</span><span class="p">(</span><span class="nx">x</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nx">u</span><span class="p">;</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nx">u</span><span class="p">;</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="c1">// like this...</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">isUndefined</span><span class="p">(</span><span class="nx">x</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="ow">void</span><span class="w"> </span><span class="mf">0</span><span class="p">;</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="c1">// ... or that second one</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">isUndefined</span><span class="p">(</span><span class="nx">x</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="p">(</span><span class="ow">typeof</span><span class="w"> </span><span class="nx">x</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="s2">"undefined"</span><span class="p">;</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="c1">// ... or that third one</span>
</pre></div>
<p>Here, calling <code>isUndefined(my_var)</code> raises a <style data-mw-deduplicate="TemplateStyles:r886049734">
/* start https://en.wikipedia.org/ */
.mw-parser-output .monospaced{font-family:monospace,monospace}
/* end https://en.wikipedia.org/ */
</style><span class="monospaced">ReferenceError</span> if <span class="monospaced">my_var</span> is an unknown identifier, whereas <code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="ow">typeof</span><span class="w"> </span><span class="nx">my_var</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="s1">'undefined'</span></code> does not.
</p>
<div class="mw-heading mw-heading3"><h3 id="Number">Number</h3></div>
<p>Numbers are represented in binary as <a href="IEEE_754" title="IEEE 754">IEEE 754</a> <a href="Floating_point" class="mw-redirect" title="Floating point">floating point</a> doubles. Although this format provides an accuracy of nearly 16 <a href="Significant_digits" class="mw-redirect" title="Significant digits">significant digits</a>, it cannot always exactly represent real numbers, including fractions.
</p><p>This becomes an issue when comparing or formatting numbers. For example:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="mf">0.2</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mf">0.1</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="mf">0.3</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays false</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="mf">0.94</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="mf">0.01</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 0.9299999999999999</span>
</pre></div>
<p>As a result, a routine such as the <span class="monospaced">toFixed()</span> method should be used to round numbers whenever they are <a rel="nofollow" class="external text" href="http://www.jibbering.com/faq/#formatNumber">formatted for output</a>.
</p><p>Numbers may be specified in any of these notations:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="mf">345</span><span class="p">;</span><span class="w"> </span><span class="c1">// an "integer", although there is only one numeric type in JavaScript</span>
<span class="mf">34.5</span><span class="p">;</span><span class="w"> </span><span class="c1">// a floating-point number</span>
<span class="mf">3.45e2</span><span class="p">;</span><span class="w"> </span><span class="c1">// another floating-point, equivalent to 345</span>
<span class="mb">0b1011</span><span class="p">;</span><span class="w"> </span><span class="c1">// a binary integer equal to 11</span>
<span class="mo">0o377</span><span class="p">;</span><span class="w"> </span><span class="c1">// an octal integer equal to 255</span>
<span class="mh">0xFF</span><span class="p">;</span><span class="w"> </span><span class="c1">// a hexadecimal integer equal to 255, digits represented by the ...</span>
<span class="w"> </span><span class="c1">// ... letters A-F may be upper or lowercase</span>
</pre></div>
<p>There is also a numeric separator, <span class="monospaced">_</span> (the underscore), introduced in ES2021:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// Note: Wikipedia syntax does not support numeric separators yet</span>
<span class="mf">1</span><span class="nx">_000_000_000</span><span class="p">;</span><span class="w"> </span><span class="c1">// Used with big numbers</span>
<span class="mf">1</span><span class="nx">_000_000</span><span class="mf">.5</span><span class="p">;</span><span class="w"> </span><span class="c1">// Support with decimals</span>
<span class="mf">1</span><span class="nx">_000e1_000</span><span class="p">;</span><span class="w"> </span><span class="c1">// Support with exponents</span>
<span class="c1">// Support with binary, octals and hex</span>
<span class="mb">0b0000</span><span class="nx">_0000_0101_1011</span><span class="p">;</span>
<span class="mo">0o0001</span><span class="nx">_3520_0237_1327</span><span class="p">;</span>
<span class="mh">0xFFFF</span><span class="nx">_FFFF_FFFF_FFFE</span><span class="p">;</span>
<span class="c1">// But users cannot use them next to a non-digit number part, or at the start or end</span>
<span class="nx">_12</span><span class="p">;</span><span class="w"> </span><span class="c1">// Variable is not defined (the underscore makes it a variable identifier)</span>
<span class="mf">12</span><span class="nx">_</span><span class="p">;</span><span class="w"> </span><span class="c1">// Syntax error (cannot be at the end of numbers)</span>
<span class="mf">12</span><span class="nx">_</span><span class="mf">.0</span><span class="p">;</span><span class="w"> </span><span class="c1">// Syntax error (does not make sense to put a separator next to the decimal point)</span>
<span class="mf">12.</span><span class="nx">_0</span><span class="p">;</span><span class="w"> </span><span class="c1">// Syntax error</span>
<span class="mf">12</span><span class="nx">e_6</span><span class="p">;</span><span class="w"> </span><span class="c1">// Syntax error (next to "e", a non-digit. Does not make sense to put a separator at the start)</span>
<span class="mf">1000</span><span class="nx">____0000</span><span class="p">;</span><span class="w"> </span><span class="c1">// Syntax error (next to "_", a non-digit. Only 1 separator at a time is allowed</span>
</pre></div>
<p>The extents <a href="Extended_real_number_line" title="Extended real number line"><b>+∞</b>, <b>−∞</b></a> and <b><a href="NaN" title="NaN">NaN</a></b> (Not a Number) of the number type may be obtained by two program expressions:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kc">Infinity</span><span class="p">;</span><span class="w"> </span><span class="c1">// positive infinity (negative obtained with -Infinity for instance)</span>
<span class="kc">NaN</span><span class="p">;</span><span class="w"> </span><span class="c1">// The Not-A-Number value, also returned as a failure in ...</span>
<span class="w"> </span><span class="c1">// ... string-to-number conversions</span>
</pre></div>
<p>Infinity and NaN are numbers:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="ow">typeof</span><span class="w"> </span><span class="kc">Infinity</span><span class="p">;</span><span class="w"> </span><span class="c1">// returns "number"</span>
<span class="ow">typeof</span><span class="w"> </span><span class="kc">NaN</span><span class="p">;</span><span class="w"> </span><span class="c1">// returns "number"</span>
</pre></div>
<p>These three special values correspond and behave as the <a href="IEEE-754" class="mw-redirect" title="IEEE-754">IEEE-754</a> describes them.
</p><p>The Number constructor (used as a function), or a unary + or -, may be used to perform explicit numeric conversion:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">myString</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"123.456"</span><span class="p">;</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">myNumber1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">Number</span><span class="p">(</span><span class="nx">myString</span><span class="p">);</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">myNumber2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="o">+</span><span class="nx">myString</span><span class="p">;</span>
</pre></div>
<p>When used as a constructor, a numeric <i>wrapper</i> object is created (though it is of little use):
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">myNumericWrapper</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">Number</span><span class="p">(</span><span class="mf">123.456</span><span class="p">);</span>
</pre></div>
<p>However, NaN is not equal to itself:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">nan</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kc">NaN</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">NaN</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="kc">NaN</span><span class="p">);</span><span class="w"> </span><span class="c1">// false</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">NaN</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">NaN</span><span class="p">);</span><span class="w"> </span><span class="c1">// false</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">NaN</span><span class="w"> </span><span class="o">!==</span><span class="w"> </span><span class="kc">NaN</span><span class="p">);</span><span class="w"> </span><span class="c1">// true</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">nan</span><span class="w"> </span><span class="o">!==</span><span class="w"> </span><span class="nx">nan</span><span class="p">);</span><span class="w"> </span><span class="c1">// true</span>
<span class="c1">// Users can use the isNaN methods to check for NaN</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">isNaN</span><span class="p">(</span><span class="s2">"converted to NaN"</span><span class="p">));</span><span class="w"> </span><span class="c1">// true</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">isNaN</span><span class="p">(</span><span class="kc">NaN</span><span class="p">));</span><span class="w"> </span><span class="c1">// true</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Number</span><span class="p">.</span><span class="nb">isNaN</span><span class="p">(</span><span class="s2">"not converted"</span><span class="p">));</span><span class="w"> </span><span class="c1">// false</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Number</span><span class="p">.</span><span class="nb">isNaN</span><span class="p">(</span><span class="kc">NaN</span><span class="p">));</span><span class="w"> </span><span class="c1">// true</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="BigInt">BigInt</h3></div>
<p>In JavaScript, regular numbers are represented with the IEEE 754 floating point type, meaning integers can only safely be stored if the value falls between <code>Number.MIN_SAFE_INTEGER</code> and <code>Number.MAX_SAFE_INTEGER</code>. <sup id="cite_ref-10" class="reference"><a href="#cite_note-10"><span class="cite-bracket">[</span>10<span class="cite-bracket">]</span></a></sup> BigInts instead represent <a href="Integers" class="mw-redirect" title="Integers">integers</a> of any size, allowing programmers to store integers too high or low to be represented with the IEEE 754 format.<sup id="cite_ref-bigint-mdn_11-0" class="reference"><a href="#cite_note-bigint-mdn-11"><span class="cite-bracket">[</span>11<span class="cite-bracket">]</span></a></sup>
</p><p>There are two ways to declare a BigInt value. An <code>n</code> can be appended to an integer, or the <code>BigInt</code> function can be used:<sup id="cite_ref-bigint-mdn_11-1" class="reference"><a href="#cite_note-bigint-mdn-11"><span class="cite-bracket">[</span>11<span class="cite-bracket">]</span></a></sup>
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">12345n</span><span class="p">;</span><span class="w"> </span><span class="c1">// Creates a variable and stores a BigInt value of 12345</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">BigInt</span><span class="p">(</span><span class="mf">12345</span><span class="p">);</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="String">String</h3></div>
<p>A <a href="String_(computer_science)" title="String (computer science)">string</a> in JavaScript is a sequence of characters. In JavaScript, strings can be created directly (as literals) by placing the series of characters between double (<code>"</code>) or single (<code>'</code>) quotes. Such strings must be written on a single line, but may include escaped newline characters (such as <code>\n</code>). The JavaScript standard allows the <a href="Grave_accent#Use_in_programming" title="Grave accent">backquote</a> character (<code>`</code>, a.k.a. grave accent or backtick) to quote multiline literal strings, as well as embedded expressions using the syntax <code>${<i>expression</i>}</code>.<sup id="cite_ref-12" class="reference"><a href="#cite_note-12"><span class="cite-bracket">[</span>12<span class="cite-bracket">]</span></a></sup>
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">greeting</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"Hello, World!"</span><span class="p">;</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">anotherGreeting</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'Greetings, people of Earth.'</span><span class="p">;</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">aMultilineGreeting</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="sb">`Warm regards,</span>
<span class="sb">John Doe.`</span>
<span class="c1">// Template literals type-coerce evaluated expressions and interpolate them into the string.</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">templateLiteral</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="sb">`This is what is stored in anotherGreeting: </span><span class="si">${</span><span class="nx">anotherGreeting</span><span class="si">}</span><span class="sb">.`</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">templateLiteral</span><span class="p">);</span><span class="w"> </span><span class="c1">// 'This is what is stored in anotherGreeting: 'Greetings, people of Earth.''</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="sb">`You are </span><span class="si">${</span><span class="nb">Math</span><span class="p">.</span><span class="nx">floor</span><span class="p">(</span><span class="nx">age</span><span class="p">)=></span><span class="mf">18</span><span class="w"> </span><span class="o">?</span><span class="w"> </span><span class="s2">"allowed"</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="s2">"not allowed"</span><span class="si">}</span><span class="sb"> to view this web page`</span><span class="p">);</span>
</pre></div>
<p>Individual characters within a string can be accessed using the <span class="monospaced">charAt</span> method (provided by <span class="monospaced">String.prototype</span>). This is the preferred way when accessing individual characters within a string, because it also works in non-modern browsers:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">h</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">greeting</span><span class="p">.</span><span class="nx">charAt</span><span class="p">(</span><span class="mf">0</span><span class="p">);</span>
</pre></div>
<p>In modern browsers, individual characters within a string can be accessed (as strings with only a single character) through the same notation as arrays:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">h</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">greeting</span><span class="p">[</span><span class="mf">0</span><span class="p">];</span>
</pre></div>
<p>However, JavaScript strings are <a href="Immutable_object" title="Immutable object">immutable</a>:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">greeting</span><span class="p">[</span><span class="mf">0</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"H"</span><span class="p">;</span><span class="w"> </span><span class="c1">// Fails.</span>
</pre></div>
<p>Applying the equality operator ("==") to two strings returns true, if the strings have the same contents, which means: of the same length and containing the same sequence of characters (case is significant for alphabets). Thus:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"World"</span><span class="p">;</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">compare1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="s2">"Hello, "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="s2">"Hello, World"</span><span class="p">);</span><span class="w"> </span><span class="c1">// Here compare1 contains true.</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">compare2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="s2">"Hello, "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="s2">"hello, World"</span><span class="p">);</span><span class="w"> </span><span class="c1">// Here compare2 contains ...</span>
<span class="w"> </span><span class="c1">// ... false since the ...</span>
<span class="w"> </span><span class="c1">// ... first characters ...</span>
<span class="w"> </span><span class="c1">// ... of both operands ...</span>
<span class="w"> </span><span class="c1">// ... are not of the same case.</span>
</pre></div>
<p>Quotes of the same type cannot be nested unless they are <a href="String_literal#Escape_character" title="String literal">escaped</a>.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">let</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'"Hello, World!" he said.'</span><span class="p">;</span><span class="w"> </span><span class="c1">// Just fine.</span>
<span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">""</span><span class="nx">Hello</span><span class="p">,</span><span class="w"> </span><span class="nx">World</span><span class="o">!</span><span class="s2">" he said."</span><span class="p">;</span><span class="w"> </span><span class="c1">// Not good.</span>
<span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"\"Hello, World!\" he said."</span><span class="p">;</span><span class="w"> </span><span class="c1">// Works by escaping " with \"</span>
</pre></div>
<p>The <span class="monospaced">String</span> constructor creates a string object (an object wrapping a string):
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">greeting</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">String</span><span class="p">(</span><span class="s2">"Hello, World!"</span><span class="p">);</span>
</pre></div>
<p>These objects have a <span class="monospaced">valueOf</span> method returning the primitive string wrapped within them:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">s</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">String</span><span class="p">(</span><span class="s2">"Hello !"</span><span class="p">);</span>
<span class="ow">typeof</span><span class="w"> </span><span class="nx">s</span><span class="p">;</span><span class="w"> </span><span class="c1">// Is 'object'.</span>
<span class="ow">typeof</span><span class="w"> </span><span class="nx">s</span><span class="p">.</span><span class="nx">valueOf</span><span class="p">();</span><span class="w"> </span><span class="c1">// Is 'string'.</span>
</pre></div>
<p>Equality between two <span class="monospaced">String</span> objects does not behave as with string primitives:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">s1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">String</span><span class="p">(</span><span class="s2">"Hello !"</span><span class="p">);</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">s2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">String</span><span class="p">(</span><span class="s2">"Hello !"</span><span class="p">);</span>
<span class="nx">s1</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="nx">s2</span><span class="p">;</span><span class="w"> </span><span class="c1">// Is false, because they are two distinct objects.</span>
<span class="nx">s1</span><span class="p">.</span><span class="nx">valueOf</span><span class="p">()</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="nx">s2</span><span class="p">.</span><span class="nx">valueOf</span><span class="p">();</span><span class="w"> </span><span class="c1">// Is true.</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Boolean">Boolean</h3></div>
<p><a href="JavaScript" title="JavaScript">JavaScript</a> provides a <a href="Boolean_data_type" title="Boolean data type">Boolean data type</a> with <span class="monospaced">true</span> and <span class="monospaced">false</span> literals. The <span class="monospaced"><a href="Typeof" title="Typeof">typeof</a></span> operator returns the string <span class="monospaced">"boolean"</span> for these <a href="Primitive_types" class="mw-redirect" title="Primitive types">primitive types</a>. When used in a logical context, <span class="monospaced">0</span>, <span class="monospaced">-0</span>, <span class="monospaced">null</span>, <span class="monospaced">NaN</span>, <span class="monospaced">undefined</span>, and the empty string (<span class="monospaced">""</span>) evaluate as <span class="monospaced">false</span> due to automatic <a href="Type_conversion" title="Type conversion">type conversion</a>. All other values (the <a href="Complement_(set_theory)" title="Complement (set theory)">complement</a> of the previous list) evaluate as <span class="monospaced">true</span>, including the strings <span class="monospaced">"0"</span>, <span class="monospaced">"false"</span> and any object.
</p>
<div class="mw-heading mw-heading3"><h3 id="Type_conversion">Type conversion</h3></div>
<p>Automatic type coercion by the equality comparison operators (<code>==</code> and <code>!=</code>) can be avoided by using the type checked comparison operators (<code>===</code> and <code>!==</code>).
</p><p>When type conversion is required, JavaScript converts <span class="monospaced">Boolean</span>, <span class="monospaced">Number</span>, <span class="monospaced">String</span>, or <span class="monospaced">Object</span> operands as follows:<sup id="cite_ref-13" class="reference"><a href="#cite_note-13"><span class="cite-bracket">[</span>13<span class="cite-bracket">]</span></a></sup>
</p>
<dl><dt><span style="font-size: 85%;">Number and String</span></dt>
<dd>The string is converted to a number value. JavaScript attempts to convert the string numeric literal to a Number type value. First, a mathematical value is derived from the string numeric literal. Next, this value is rounded to nearest Number type value.</dd>
<dt><span style="font-size: 85%;">Boolean</span></dt>
<dd>If one of the operands is a Boolean, the Boolean operand is converted to 1 if it is <span class="monospaced">true</span>, or to 0 if it is <span class="monospaced">false</span>.</dd>
<dt><span style="font-size: 85%;">Object</span></dt>
<dd>If an object is compared with a number or string, JavaScript attempts to return the default value for the object. An object is converted to a primitive String or Number value, using the <span class="monospaced">.valueOf()</span> or <span class="monospaced">.toString()</span> methods of the object. If this fails, a runtime error is generated.</dd></dl>
<div class="mw-heading mw-heading4"><h4 id="Boolean_type_conversion">Boolean type conversion</h4></div>
<p>
</p>
<div role="note" class="hatnote navigation-not-searchable">Further information: <a href="Truthy_(computing)" class="mw-redirect" title="Truthy (computing)">Truthy (computing)</a></div>
<p><a href="Douglas_Crockford" title="Douglas Crockford">Douglas Crockford</a> advocates the terms "truthy" and "falsy" to describe how values of various types behave when evaluated in a logical context, especially in regard to edge cases.<sup id="cite_ref-14" class="reference"><a href="#cite_note-14"><span class="cite-bracket">[</span>14<span class="cite-bracket">]</span></a></sup>
The binary logical operators returned a Boolean value in early versions of JavaScript, but now they return one of the operands instead. The left–operand is returned, if it can be evaluated as : <span class="monospaced">false</span>, in the case of <a href="Logical_conjunction" title="Logical conjunction">conjunction</a>: (<code>a && b</code>), or <span class="monospaced">true</span>, in the case of <a href="Logical_disjunction" title="Logical disjunction">disjunction</a>: (<code>a || b</code>); otherwise the right–operand is returned. Automatic type coercion by the comparison operators may differ for cases of mixed Boolean and number-compatible operands (including strings that can be evaluated as a number, or objects that can be evaluated as such a string), because the Boolean operand will be compared as a numeric value. This may be unexpected. An expression can be explicitly cast to a Boolean primitive by doubling the logical <a href="Negation" title="Negation">negation operator</a>: (<span class="monospaced">!!</span>), using the <span class="monospaced">Boolean()</span> function, or using the <a href="Conditional_(programming)" class="mw-redirect" title="Conditional (programming)">conditional operator</a>: (<code>c ? t : f</code>).
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// Automatic type coercion</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">true</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mf">2</span><span class="w"> </span><span class="p">);</span><span class="w"> </span><span class="c1">// false... true → 1 !== 2 ← 2</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">false</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mf">2</span><span class="w"> </span><span class="p">);</span><span class="w"> </span><span class="c1">// false... false → 0 !== 2 ← 2</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">true</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mf">1</span><span class="w"> </span><span class="p">);</span><span class="w"> </span><span class="c1">// true.... true → 1 === 1 ← 1</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">false</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="mf">0</span><span class="w"> </span><span class="p">);</span><span class="w"> </span><span class="c1">// true.... false → 0 === 0 ← 0</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">true</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="s2">"2"</span><span class="p">);</span><span class="w"> </span><span class="c1">// false... true → 1 !== 2 ← "2"</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">false</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="s2">"2"</span><span class="p">);</span><span class="w"> </span><span class="c1">// false... false → 0 !== 2 ← "2"</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">true</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="s2">"1"</span><span class="p">);</span><span class="w"> </span><span class="c1">// true.... true → 1 === 1 ← "1"</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">false</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="s2">"0"</span><span class="p">);</span><span class="w"> </span><span class="c1">// true.... false → 0 === 0 ← "0"</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">false</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="s2">""</span><span class="w"> </span><span class="p">);</span><span class="w"> </span><span class="c1">// true.... false → 0 === 0 ← ""</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">false</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="kc">NaN</span><span class="p">);</span><span class="w"> </span><span class="c1">// false... false → 0 !== NaN</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">NaN</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="kc">NaN</span><span class="p">);</span><span class="w"> </span><span class="c1">// false...... NaN is not equivalent to anything, including NaN.</span>
<span class="c1">// Type checked comparison (no conversion of types and values)</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">true</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="mf">1</span><span class="p">);</span><span class="w"> </span><span class="c1">// false...... data types do not match</span>
<span class="c1">// Explicit type coercion</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">true</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="o">!!</span><span class="mf">2</span><span class="p">);</span><span class="w"> </span><span class="c1">// true.... data types and values match</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="kc">true</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="o">!!</span><span class="mf">0</span><span class="p">);</span><span class="w"> </span><span class="c1">// false... data types match, but values differ</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="w"> </span><span class="mf">1</span><span class="w"> </span><span class="o">?</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// true.... only ±0 and NaN are "falsy" numbers</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"0"</span><span class="w"> </span><span class="o">?</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// true.... only the empty string is "falsy"</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">({}));</span><span class="w"> </span><span class="c1">// true.... all objects are "truthy"</span>
</pre></div>
<p>The new operator can be used to create an object wrapper for a Boolean primitive. However, the <span class="monospaced">typeof</span> operator does not return <span class="monospaced">boolean</span> for the object wrapper, it returns <span class="monospaced">object</span>. Because all objects evaluate as <span class="monospaced">true</span>, a method such as <span class="monospaced">.valueOf()</span>, or <span class="monospaced">.toString()</span>, must be used to retrieve the wrapped value. For explicit coercion to the Boolean type, Mozilla recommends that the <span class="monospaced">Boolean()</span> function (without <span class="monospaced">new</span>) be used in preference to the Boolean object.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// Object false {}</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">t</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="nx">b</span><span class="p">);</span><span class="w"> </span><span class="c1">// Boolean true</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">f</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="nx">b</span><span class="p">.</span><span class="nx">valueOf</span><span class="p">());</span><span class="w"> </span><span class="c1">// Boolean false</span>
<span class="kd">let</span><span class="w"> </span><span class="nx">n</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="nx">b</span><span class="p">);</span><span class="w"> </span><span class="c1">// Not recommended</span>
<span class="nx">n</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="nx">b</span><span class="p">.</span><span class="nx">valueOf</span><span class="p">());</span><span class="w"> </span><span class="c1">// Preferred</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="mf">0</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="o">-</span><span class="mf">0</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="s2">""</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="kc">null</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="kc">undefined</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="nx">b</span><span class="p">.</span><span class="nx">valueOf</span><span class="p">()</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="o">!</span><span class="ow">new</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">()</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="o">!</span><span class="nx">t</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"Never this"</span><span class="p">);</span>
<span class="p">}</span><span class="w"> </span><span class="k">else</span><span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">([]</span><span class="w"> </span><span class="o">&&</span><span class="w"> </span><span class="p">{}</span><span class="w"> </span><span class="o">&&</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o">&&</span><span class="w"> </span><span class="ow">typeof</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="s2">"object"</span><span class="w"> </span><span class="o">&&</span><span class="w"> </span><span class="nx">b</span><span class="p">.</span><span class="nx">toString</span><span class="p">()</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="s2">"false"</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"Always this"</span><span class="p">);</span>
<span class="p">}</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Symbol">Symbol</h3></div>
<p>Symbols are a feature introduced in <a href="ES6" class="mw-redirect" title="ES6">ES6</a>. Each symbol is guaranteed to be a unique value, and they can be used for <a href="Encapsulation_(computer_programming)" title="Encapsulation (computer programming)">encapsulation</a>.<sup id="cite_ref-15" class="reference"><a href="#cite_note-15"><span class="cite-bracket">[</span>15<span class="cite-bracket">]</span></a></sup>
</p><p>Example:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">let</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">Symbol</span><span class="p">(</span><span class="mf">1</span><span class="p">);</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">y</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">Symbol</span><span class="p">(</span><span class="mf">1</span><span class="p">);</span>
<span class="nx">x</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nx">y</span><span class="p">;</span><span class="w"> </span><span class="c1">// => false</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">symbolObject</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{};</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">normalObject</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{};</span>
<span class="c1">// since x and y are unique,</span>
<span class="c1">// they can be used as unique keys in an object</span>
<span class="nx">symbolObject</span><span class="p">[</span><span class="nx">x</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">1</span><span class="p">;</span>
<span class="nx">symbolObject</span><span class="p">[</span><span class="nx">y</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">2</span><span class="p">;</span>
<span class="nx">symbolObject</span><span class="p">[</span><span class="nx">x</span><span class="p">];</span><span class="w"> </span><span class="c1">// => 1</span>
<span class="nx">symbolObject</span><span class="p">[</span><span class="nx">y</span><span class="p">];</span><span class="w"> </span><span class="c1">// => 2</span>
<span class="c1">// as compared to normal numeric keys</span>
<span class="nx">normalObject</span><span class="p">[</span><span class="mf">1</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">1</span><span class="p">;</span>
<span class="nx">normalObject</span><span class="p">[</span><span class="mf">1</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">2</span><span class="p">;</span><span class="w"> </span><span class="c1">// overrides the value of 1</span>
<span class="nx">normalObject</span><span class="p">[</span><span class="mf">1</span><span class="p">];</span><span class="w"> </span><span class="c1">// => 2</span>
<span class="c1">// changing the value of x does not change the key stored in the object</span>
<span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">Symbol</span><span class="p">(</span><span class="mf">3</span><span class="p">);</span>
<span class="nx">symbolObject</span><span class="p">[</span><span class="nx">x</span><span class="p">];</span><span class="w"> </span><span class="c1">// => undefined</span>
<span class="c1">// changing x back just creates another unique Symbol</span>
<span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">Symbol</span><span class="p">(</span><span class="mf">1</span><span class="p">);</span>
<span class="nx">symbolObject</span><span class="p">[</span><span class="nx">x</span><span class="p">];</span><span class="w"> </span><span class="c1">// => undefined</span>
</pre></div>
<p>There are also <i>well known symbols</i>.
</p><p>One of which is <code>Symbol.iterator</code>; if something implements <code>Symbol.iterator</code>, it is iterable:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">,</span><span class="w"> </span><span class="mf">3</span><span class="p">,</span><span class="w"> </span><span class="mf">4</span><span class="p">];</span><span class="w"> </span><span class="c1">// x is an Array</span>
<span class="nx">x</span><span class="p">[</span><span class="nb">Symbol</span><span class="p">.</span><span class="nx">iterator</span><span class="p">]</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nb">Array</span><span class="p">.</span><span class="nx">prototype</span><span class="p">[</span><span class="nb">Symbol</span><span class="p">.</span><span class="nx">iterator</span><span class="p">];</span><span class="w"> </span><span class="c1">// and Arrays are iterable</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">xIterator</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">x</span><span class="p">[</span><span class="nb">Symbol</span><span class="p">.</span><span class="nx">iterator</span><span class="p">]();</span><span class="w"> </span><span class="c1">// The [Symbol.iterator] function should provide an iterator for x</span>
<span class="nx">xIterator</span><span class="p">.</span><span class="nx">next</span><span class="p">();</span><span class="w"> </span><span class="c1">// { value: 1, done: false }</span>
<span class="nx">xIterator</span><span class="p">.</span><span class="nx">next</span><span class="p">();</span><span class="w"> </span><span class="c1">// { value: 2, done: false }</span>
<span class="nx">xIterator</span><span class="p">.</span><span class="nx">next</span><span class="p">();</span><span class="w"> </span><span class="c1">// { value: 3, done: false }</span>
<span class="nx">xIterator</span><span class="p">.</span><span class="nx">next</span><span class="p">();</span><span class="w"> </span><span class="c1">// { value: 4, done: false }</span>
<span class="nx">xIterator</span><span class="p">.</span><span class="nx">next</span><span class="p">();</span><span class="w"> </span><span class="c1">// { value: undefined, done: true }</span>
<span class="nx">xIterator</span><span class="p">.</span><span class="nx">next</span><span class="p">();</span><span class="w"> </span><span class="c1">// { value: undefined, done: true }</span>
<span class="c1">// for..of loops automatically iterate values</span>
<span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kd">const</span><span class="w"> </span><span class="nx">value</span><span class="w"> </span><span class="k">of</span><span class="w"> </span><span class="nx">x</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">value</span><span class="p">);</span><span class="w"> </span><span class="c1">// 1 2 3 4</span>
<span class="p">}</span>
<span class="c1">// Sets are also iterable:</span>
<span class="p">[</span><span class="nb">Symbol</span><span class="p">.</span><span class="nx">iterator</span><span class="p">]</span><span class="w"> </span><span class="ow">in</span><span class="w"> </span><span class="nb">Set</span><span class="p">.</span><span class="nx">prototype</span><span class="p">;</span><span class="w"> </span><span class="c1">// true</span>
<span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kd">const</span><span class="w"> </span><span class="nx">value</span><span class="w"> </span><span class="k">of</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">Set</span><span class="p">([</span><span class="s1">'apple'</span><span class="p">,</span><span class="w"> </span><span class="s1">'orange'</span><span class="p">]))</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">value</span><span class="p">);</span><span class="w"> </span><span class="c1">// "apple" "orange"</span>
<span class="p">}</span>
</pre></div>
<div class="mw-heading mw-heading2"><h2 id="Native_objects">Native objects</h2></div>
<p>The JavaScript language provides a handful of native <a href="Object_(computer_science)" title="Object (computer science)">objects</a>. JavaScript native objects are considered part of the JavaScript specification. JavaScript environment notwithstanding, this set of objects should always be available.
</p>
<div class="mw-heading mw-heading3"><h3 id="Array">Array</h3></div>
<div role="note" class="hatnote navigation-not-searchable">Main article: <a href="Array_data_type" class="mw-redirect" title="Array data type">Array data type</a></div>
<p>An <a href="Array_data_type" class="mw-redirect" title="Array data type">Array</a> is a JavaScript object prototyped from the <code>Array</code> constructor specifically designed to store data values indexed by integer keys. Arrays, unlike the basic Object type, are prototyped with methods and properties to aid the programmer in routine tasks (for example, <code>join</code>, <code>slice</code>, and <code>push</code>).
</p><p>As in the C family, arrays use a zero-based indexing scheme: A value that is inserted into an empty array by means of the <code>push</code> method occupies the 0th index of the array.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">myArray</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[];</span><span class="w"> </span><span class="c1">// Point the variable myArray to a newly ...</span>
<span class="w"> </span><span class="c1">// ... created, empty Array</span>
<span class="nx">myArray</span><span class="p">.</span><span class="nx">push</span><span class="p">(</span><span class="s2">"hello World"</span><span class="p">);</span><span class="w"> </span><span class="c1">// Fill the next empty index, in this case 0</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">myArray</span><span class="p">[</span><span class="mf">0</span><span class="p">]);</span><span class="w"> </span><span class="c1">// Equivalent to console.log("hello World");</span>
</pre></div>
<p>Arrays have a <code>length</code> property that is guaranteed to always be larger than the largest integer index used in the array. It is automatically updated, if one creates a property with an even larger index. Writing a smaller number to the <code>length</code> property will remove larger indices.
</p><p>Elements of <code>Array</code>s may be accessed using normal object property access notation:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">myArray</span><span class="p">[</span><span class="mf">1</span><span class="p">];</span><span class="w"> </span><span class="c1">// the 2nd item in myArray</span>
<span class="nx">myArray</span><span class="p">[</span><span class="s2">"1"</span><span class="p">];</span>
</pre></div>
<p>The above two are equivalent. It is not possible to use the "dot"-notation or strings with alternative representations of the number:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">myArray</span><span class="mf">.1</span><span class="p">;</span><span class="w"> </span><span class="c1">// syntax error</span>
<span class="nx">myArray</span><span class="p">[</span><span class="s2">"01"</span><span class="p">];</span><span class="w"> </span><span class="c1">// not the same as myArray[1]</span>
</pre></div>
<p>Declaration of an array can use either an <code>Array</code> literal or the <code>Array</code> constructor:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">let</span><span class="w"> </span><span class="nx">myArray</span><span class="p">;</span>
<span class="c1">// Array literals</span>
<span class="nx">myArray</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">];</span><span class="w"> </span><span class="c1">// length of 2</span>
<span class="nx">myArray</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">,];</span><span class="w"> </span><span class="c1">// same array - Users can also have an extra comma at the end</span>
<span class="c1">// It is also possible to not fill in parts of the array</span>
<span class="nx">myArray</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="mf">0</span><span class="p">,</span><span class="w"> </span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="cm">/* hole */</span><span class="p">,</span><span class="w"> </span><span class="cm">/* hole */</span><span class="p">,</span><span class="w"> </span><span class="mf">4</span><span class="p">,</span><span class="w"> </span><span class="mf">5</span><span class="p">];</span><span class="w"> </span><span class="c1">// length of 6</span>
<span class="nx">myArray</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="mf">0</span><span class="p">,</span><span class="w"> </span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="cm">/* hole */</span><span class="p">,</span><span class="w"> </span><span class="cm">/* hole */</span><span class="p">,</span><span class="w"> </span><span class="mf">4</span><span class="p">,</span><span class="w"> </span><span class="mf">5</span><span class="p">,];</span><span class="w"> </span><span class="c1">// same array</span>
<span class="nx">myArray</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="mf">0</span><span class="p">,</span><span class="w"> </span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="cm">/* hole */</span><span class="p">,</span><span class="w"> </span><span class="cm">/* hole */</span><span class="p">,</span><span class="w"> </span><span class="mf">4</span><span class="p">,</span><span class="w"> </span><span class="mf">5</span><span class="p">,</span><span class="w"> </span><span class="cm">/* hole */</span><span class="p">,];</span><span class="w"> </span><span class="c1">// length of 7</span>
<span class="c1">// With the constructor</span>
<span class="nx">myArray</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">Array</span><span class="p">(</span><span class="mf">0</span><span class="p">,</span><span class="w"> </span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">,</span><span class="w"> </span><span class="mf">3</span><span class="p">,</span><span class="w"> </span><span class="mf">4</span><span class="p">,</span><span class="w"> </span><span class="mf">5</span><span class="p">);</span><span class="w"> </span><span class="c1">// length of 6</span>
<span class="nx">myArray</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">Array</span><span class="p">(</span><span class="mf">365</span><span class="p">);</span><span class="w"> </span><span class="c1">// an empty array with length 365</span>
</pre></div>
<p><a href="Array_data_structure" class="mw-redirect" title="Array data structure">Arrays</a> are implemented so that only the defined elements use memory; they are "<a href="Sparse_array" class="mw-redirect" title="Sparse array">sparse arrays</a>". Setting <code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="nx">myArray</span><span class="p">[</span><span class="mf">10</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'someThing'</span></code> and <code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="nx">myArray</span><span class="p">[</span><span class="mf">57</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s1">'somethingOther'</span></code> only uses space for these two elements, just like any other object. The <code>length</code> of the array will still be reported as 58. The maximum length of an array is 4,294,967,295 which corresponds to 32-bit binary number (11111111111111111111111111111111)<sub>2</sub>.
</p><p>One can use the object declaration literal to create objects that behave much like associative arrays in other languages:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">dog</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="nx">color</span><span class="o">:</span><span class="w"> </span><span class="s2">"brown"</span><span class="p">,</span><span class="w"> </span><span class="nx">size</span><span class="o">:</span><span class="w"> </span><span class="s2">"large"</span><span class="p">};</span>
<span class="nx">dog</span><span class="p">[</span><span class="s2">"color"</span><span class="p">];</span><span class="w"> </span><span class="c1">// results in "brown"</span>
<span class="nx">dog</span><span class="p">.</span><span class="nx">color</span><span class="p">;</span><span class="w"> </span><span class="c1">// also results in "brown"</span>
</pre></div>
<p>One can use the object and array declaration literals to quickly create arrays that are associative, multidimensional, or both. (Technically, JavaScript does not support multidimensional arrays, but one can mimic them with arrays-of-arrays.)
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">cats</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[{</span><span class="nx">color</span><span class="o">:</span><span class="w"> </span><span class="s2">"brown"</span><span class="p">,</span><span class="w"> </span><span class="nx">size</span><span class="o">:</span><span class="w"> </span><span class="s2">"large"</span><span class="p">},</span>
<span class="w"> </span><span class="p">{</span><span class="nx">color</span><span class="o">:</span><span class="w"> </span><span class="s2">"black"</span><span class="p">,</span><span class="w"> </span><span class="nx">size</span><span class="o">:</span><span class="w"> </span><span class="s2">"small"</span><span class="p">}];</span>
<span class="nx">cats</span><span class="p">[</span><span class="mf">0</span><span class="p">][</span><span class="s2">"size"</span><span class="p">];</span><span class="w"> </span><span class="c1">// results in "large"</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">dogs</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="nx">rover</span><span class="o">:</span><span class="w"> </span><span class="p">{</span><span class="nx">color</span><span class="o">:</span><span class="w"> </span><span class="s2">"brown"</span><span class="p">,</span><span class="w"> </span><span class="nx">size</span><span class="o">:</span><span class="w"> </span><span class="s2">"large"</span><span class="p">},</span>
<span class="w"> </span><span class="nx">spot</span><span class="o">:</span><span class="w"> </span><span class="p">{</span><span class="nx">color</span><span class="o">:</span><span class="w"> </span><span class="s2">"black"</span><span class="p">,</span><span class="w"> </span><span class="nx">size</span><span class="o">:</span><span class="w"> </span><span class="s2">"small"</span><span class="p">}};</span>
<span class="nx">dogs</span><span class="p">[</span><span class="s2">"spot"</span><span class="p">][</span><span class="s2">"size"</span><span class="p">];</span><span class="w"> </span><span class="c1">// results in "small"</span>
<span class="nx">dogs</span><span class="p">.</span><span class="nx">rover</span><span class="p">.</span><span class="nx">color</span><span class="p">;</span><span class="w"> </span><span class="c1">// results in "brown"</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Date">Date</h3></div>
<p>A <code>Date</code> object stores a signed millisecond count with zero representing 1970-01-01 00:00:00 UT and a range of ±10<sup>8</sup> days. There are several ways of providing arguments to the <code>Date</code> constructor. Note that months are zero-based.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="ow">new</span><span class="w"> </span><span class="nb">Date</span><span class="p">();</span><span class="w"> </span><span class="c1">// create a new Date instance representing the current time/date.</span>
<span class="ow">new</span><span class="w"> </span><span class="nb">Date</span><span class="p">(</span><span class="mf">2010</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">,</span><span class="w"> </span><span class="mf">1</span><span class="p">);</span><span class="w"> </span><span class="c1">// create a new Date instance representing 2010-Mar-01 00:00:00</span>
<span class="ow">new</span><span class="w"> </span><span class="nb">Date</span><span class="p">(</span><span class="mf">2010</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">,</span><span class="w"> </span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">14</span><span class="p">,</span><span class="w"> </span><span class="mf">25</span><span class="p">,</span><span class="w"> </span><span class="mf">30</span><span class="p">);</span><span class="w"> </span><span class="c1">// create a new Date instance representing 2010-Mar-01 14:25:30</span>
<span class="ow">new</span><span class="w"> </span><span class="nb">Date</span><span class="p">(</span><span class="s2">"2010-3-1 14:25:30"</span><span class="p">);</span><span class="w"> </span><span class="c1">// create a new Date instance from a String.</span>
</pre></div>
<p>Methods to extract fields are provided, as well as a useful <code>toString</code>:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">d</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">Date</span><span class="p">(</span><span class="mf">2010</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">,</span><span class="w"> </span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">14</span><span class="p">,</span><span class="w"> </span><span class="mf">25</span><span class="p">,</span><span class="w"> </span><span class="mf">30</span><span class="p">);</span><span class="w"> </span><span class="c1">// 2010-Mar-01 14:25:30;</span>
<span class="c1">// Displays '2010-3-1 14:25:30':</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">d</span><span class="p">.</span><span class="nx">getFullYear</span><span class="p">()</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s1">'-'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="p">(</span><span class="nx">d</span><span class="p">.</span><span class="nx">getMonth</span><span class="p">()</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mf">1</span><span class="p">)</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s1">'-'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">d</span><span class="p">.</span><span class="nx">getDate</span><span class="p">()</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s1">' '</span>
<span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">d</span><span class="p">.</span><span class="nx">getHours</span><span class="p">()</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s1">':'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">d</span><span class="p">.</span><span class="nx">getMinutes</span><span class="p">()</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s1">':'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">d</span><span class="p">.</span><span class="nx">getSeconds</span><span class="p">());</span>
<span class="c1">// Built-in toString returns something like 'Mon 1 March, 2010 14:25:30 GMT-0500 (EST)':</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">d</span><span class="p">);</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Error">Error</h3></div>
<p>Custom error messages can be created using the <code>Error</code> class:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">throw</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="ne">Error</span><span class="p">(</span><span class="s2">"Something went wrong."</span><span class="p">);</span>
</pre></div>
<p>These can be caught by try...catch...finally blocks as described in the section on <a href="#Exception_handling">exception handling</a>.
</p>
<div class="mw-heading mw-heading3"><h3 id="Math">Math</h3></div>
<p>The <span class="monospaced">Math</span> object contains various math-related constants (for example, <span class="texhtml mvar" style="font-style:italic;">π</span>) and functions (for example, cosine). (Note that the <span class="monospaced">Math</span> object has no constructor, unlike <span class="monospaced">Array</span> or <span class="monospaced">Date</span>. All its methods are "static", that is "class" methods.) All the trigonometric functions use angles expressed in <a href="Radian" title="Radian">radians</a>, not <a href="Degree_(angle)" title="Degree (angle)">degrees</a> or <a href="Grad_(angle)" class="mw-redirect" title="Grad (angle)">grads</a>.
</p>
<table class="wikitable" border="1">
<caption>Some of the constants contained in the Math object
</caption>
<tbody><tr>
<th>Property</th>
<th>Returned value<br>rounded to 5 digits</th>
<th>Description
</th></tr>
<tr>
<td><span class="monospaced">Math.E</span></td>
<td>2.7183</td>
<td><span class="texhtml mvar" style="font-style:italic;"><a href="E_(mathematical_constant)" title="E (mathematical constant)">e</a></span>: Natural logarithm base
</td></tr>
<tr>
<td><span class="monospaced">Math.LN2</span></td>
<td>0.69315</td>
<td><a href="Natural_logarithm" title="Natural logarithm">Natural logarithm</a> of 2
</td></tr>
<tr>
<td><span class="monospaced">Math.LN10</span></td>
<td>2.3026</td>
<td>Natural logarithm of 10
</td></tr>
<tr>
<td><span class="monospaced">Math.LOG2E</span></td>
<td>1.4427</td>
<td><a href="Logarithm" title="Logarithm">Logarithm</a> to the base 2 of <span class="texhtml mvar" style="font-style:italic;">e</span>
</td></tr>
<tr>
<td><span class="monospaced">Math.LOG10E</span></td>
<td>0.43429</td>
<td>Logarithm to the base 10 of <span class="texhtml mvar" style="font-style:italic;">e</span>
</td></tr>
<tr>
<td><span class="monospaced">Math.PI</span></td>
<td>3.14159</td>
<td><a href="Pi" title="Pi"><span class="texhtml mvar" style="font-style:italic;">π</span></a>: circumference/diameter of a circle
</td></tr>
<tr>
<td><span class="monospaced">Math.SQRT1_2</span></td>
<td>0.70711</td>
<td><a href="Square_root" title="Square root">Square root</a> of ½
</td></tr>
<tr>
<td><span class="monospaced">Math.SQRT2</span></td>
<td>1.4142</td>
<td><a href="Square_root_of_2" title="Square root of 2">Square root of 2</a>
</td></tr></tbody></table>
<table class="wikitable" border="1">
<caption>Methods of the Math object
</caption>
<tbody><tr>
<th>Example</th>
<th>Returned value<br>rounded to 5 digits</th>
<th>Description
</th></tr>
<tr>
<td><span class="monospaced">Math.abs(-2.3)</span></td>
<td>2.3</td>
<td><a href="Absolute_value" title="Absolute value">Absolute value</a>
</td></tr>
<tr>
<td><span class="monospaced">Math.acos(Math.SQRT1_2)</span></td>
<td><span class="nowrap">0.78540 <a href="Rad_(unit)" class="mw-redirect" title="Rad (unit)">rad</a></span> = 45°</td>
<td><a href="Arccosine" class="mw-redirect" title="Arccosine">Arccosine</a>
</td></tr>
<tr>
<td><span class="monospaced">Math.asin(Math.SQRT1_2)</span></td>
<td><span class="nowrap">0.78540 rad</span> = 45°</td>
<td><a href="Arcsine" class="mw-redirect" title="Arcsine">Arcsine</a>
</td></tr>
<tr>
<td><span class="monospaced">Math.atan(1)</span></td>
<td><span class="nowrap">0.78540 rad</span> = 45°</td>
<td>Half circle <a href="Arctangent" class="mw-redirect" title="Arctangent">arctangent</a> (<span class="nowrap"><span class="mwe-math-element mwe-math-element-inline"><span class="mwe-math-mathml-inline mwe-math-mathml-a11y" style="display: none;"><math xmlns="http://www.w3.org/1998/Math/MathML" alttext="{\displaystyle -\pi /2}">
<semantics>
<mrow class="MJX-TeXAtom-ORD">
<mstyle displaystyle="true" scriptlevel="0">
<mo>−<!-- − --></mo>
<mi>π<!-- π --></mi>
<mrow class="MJX-TeXAtom-ORD">
<mo>/</mo>
</mrow>
<mn>2</mn>
</mstyle>
</mrow>
<annotation encoding="application/x-tex">{\displaystyle -\pi /2}</annotation>
</semantics>
</math></span><img src="./4644f935f59f6d1bac8c2ef618246eee6c1f07b3.svg" class="mwe-math-fallback-image-inline mw-invert skin-invert" aria-hidden="true" style="vertical-align: -0.838ex; width:5.465ex; height:2.843ex;" alt="{\displaystyle -\pi /2}" loading="lazy"></span></span> to <span class="nowrap"><span class="mwe-math-element mwe-math-element-inline"><span class="mwe-math-mathml-inline mwe-math-mathml-a11y" style="display: none;"><math xmlns="http://www.w3.org/1998/Math/MathML" alttext="{\displaystyle +\pi /2}">
<semantics>
<mrow class="MJX-TeXAtom-ORD">
<mstyle displaystyle="true" scriptlevel="0">
<mo>+</mo>
<mi>π<!-- π --></mi>
<mrow class="MJX-TeXAtom-ORD">
<mo>/</mo>
</mrow>
<mn>2</mn>
</mstyle>
</mrow>
<annotation encoding="application/x-tex">{\displaystyle +\pi /2}</annotation>
</semantics>
</math></span><img src="./b7fac17a374c4e9eae65df5546ec64b79b0e16ca.svg" class="mwe-math-fallback-image-inline mw-invert skin-invert" aria-hidden="true" style="vertical-align: -0.838ex; width:5.465ex; height:2.843ex;" alt="{\displaystyle +\pi /2}" loading="lazy"></span></span>)
</td></tr>
<tr>
<td><span class="monospaced">Math.atan2(-3.7, -3.7)</span></td>
<td><span class="nowrap">−2.3562 rad</span> = <span class="nowrap">−135°</span></td>
<td>Whole circle arctangent (<span class="nowrap"><span class="mwe-math-element mwe-math-element-inline"><span class="mwe-math-mathml-inline mwe-math-mathml-a11y" style="display: none;"><math xmlns="http://www.w3.org/1998/Math/MathML" alttext="{\displaystyle -\pi }">
<semantics>
<mrow class="MJX-TeXAtom-ORD">
<mstyle displaystyle="true" scriptlevel="0">
<mo>−<!-- − --></mo>
<mi>π<!-- π --></mi>
</mstyle>
</mrow>
<annotation encoding="application/x-tex">{\displaystyle -\pi }</annotation>
</semantics>
</math></span><img src="./f2359073fe90a84a705e02f0c1e63b32df850a60.svg" class="mwe-math-fallback-image-inline mw-invert skin-invert" aria-hidden="true" style="vertical-align: -0.505ex; width:3.14ex; height:2.176ex;" alt="{\displaystyle -\pi }" loading="lazy"></span></span> to <span class="nowrap"><span class="mwe-math-element mwe-math-element-inline"><span class="mwe-math-mathml-inline mwe-math-mathml-a11y" style="display: none;"><math xmlns="http://www.w3.org/1998/Math/MathML" alttext="{\displaystyle +\pi }">
<semantics>
<mrow class="MJX-TeXAtom-ORD">
<mstyle displaystyle="true" scriptlevel="0">
<mo>+</mo>
<mi>π<!-- π --></mi>
</mstyle>
</mrow>
<annotation encoding="application/x-tex">{\displaystyle +\pi }</annotation>
</semantics>
</math></span><img src="./cbae717a544919265768ad63c73919176113fb12.svg" class="mwe-math-fallback-image-inline mw-invert skin-invert" aria-hidden="true" style="vertical-align: -0.505ex; width:3.14ex; height:2.176ex;" alt="{\displaystyle +\pi }" loading="lazy"></span></span>)
</td></tr>
<tr>
<td><span class="monospaced">Math.ceil(1.1)</span></td>
<td>2</td>
<td>Ceiling: <a href="Rounding" title="Rounding">round</a> up to smallest integer ≥ argument
</td></tr>
<tr>
<td><span class="monospaced">Math.cos(Math.PI/4)</span></td>
<td>0.70711</td>
<td><a href="Trigonometric_functions" title="Trigonometric functions">Cosine</a>
</td></tr>
<tr>
<td><span class="monospaced">Math.exp(1)</span></td>
<td>2.7183</td>
<td><a href="Exponential_function" title="Exponential function">Exponential function</a>: <span class="texhtml mvar" style="font-style:italic;">e</span> raised to this power
</td></tr>
<tr>
<td><span class="monospaced">Math.floor(1.9)</span></td>
<td>1</td>
<td>Floor: round down to largest integer ≤ argument
</td></tr>
<tr>
<td><span class="monospaced">Math.log(Math.E)</span></td>
<td>1</td>
<td>Natural logarithm, base <span class="texhtml mvar" style="font-style:italic;">e</span>
</td></tr>
<tr>
<td><span class="monospaced">Math.max(1, -2)</span></td>
<td>1</td>
<td>Maximum: <span class="monospaced">(x > y) ? x : y</span>
</td></tr>
<tr>
<td><span class="monospaced">Math.min(1, -2)</span></td>
<td><span class="nowrap">−2</span></td>
<td>Minimum: <span class="monospaced">(x < y) ? x : y</span>
</td></tr>
<tr>
<td><span class="monospaced">Math.pow(-3, 2)</span></td>
<td>9</td>
<td><a href="Exponentiation" title="Exponentiation">Exponentiation</a> (raised to the power of): <span class="monospaced">Math.pow(x, y)</span> gives x<sup>y</sup>
</td></tr>
<tr>
<td><span class="monospaced">Math.random()</span></td>
<td>e.g. 0.17068</td>
<td><a href="Pseudorandom" class="mw-redirect" title="Pseudorandom">Pseudorandom</a> number between 0 (inclusive) and 1 (exclusive)
</td></tr>
<tr>
<td><span class="monospaced">Math.round(1.5)</span></td>
<td>2</td>
<td>Round to the nearest integer; half fractions are rounded up (e.g. 1.5 rounds to 2)
</td></tr>
<tr>
<td><span class="monospaced">Math.sin(Math.PI/4)</span></td>
<td>0.70711</td>
<td><a href="Sine" class="mw-redirect" title="Sine">Sine</a>
</td></tr>
<tr>
<td><span class="monospaced">Math.sqrt(49)</span></td>
<td>7</td>
<td>Square root
</td></tr>
<tr>
<td><span class="monospaced">Math.tan(Math.PI/4)</span></td>
<td>1</td>
<td><a href="Trigonometric_functions" title="Trigonometric functions">Tangent</a>
</td></tr></tbody></table>
<div class="mw-heading mw-heading3"><h3 id="Regular_expression">Regular expression</h3></div>
<div role="note" class="hatnote navigation-not-searchable">Main article: <a href="Regular_expression" title="Regular expression">Regular expression</a></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="sr">/expression/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="nx">string</span><span class="p">);</span><span class="w"> </span><span class="c1">// returns Boolean</span>
<span class="s2">"string"</span><span class="p">.</span><span class="nx">search</span><span class="p">(</span><span class="sr">/expression/</span><span class="p">);</span><span class="w"> </span><span class="c1">// returns position Number</span>
<span class="s2">"string"</span><span class="p">.</span><span class="nx">replace</span><span class="p">(</span><span class="sr">/expression/</span><span class="p">,</span><span class="w"> </span><span class="nx">replacement</span><span class="p">);</span>
<span class="c1">// Here are some examples</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/Tom/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"My name is Tom"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"Hello Tom!"</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"My name is Tom"</span><span class="p">.</span><span class="nx">search</span><span class="p">(</span><span class="sr">/Tom/</span><span class="p">));</span><span class="w"> </span><span class="c1">// == 11 (letters before Tom)</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"My name is Tom"</span><span class="p">.</span><span class="nx">replace</span><span class="p">(</span><span class="sr">/Tom/</span><span class="p">,</span><span class="w"> </span><span class="s2">"John"</span><span class="p">));</span><span class="w"> </span><span class="c1">// == "My name is John"</span>
</pre></div>
<div class="mw-heading mw-heading4"><h4 id="Character_classes">Character classes</h4></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// \d - digit</span>
<span class="c1">// \D - non digit</span>
<span class="c1">// \s - space</span>
<span class="c1">// \S - non space</span>
<span class="c1">// \w - word char</span>
<span class="c1">// \W - non word</span>
<span class="c1">// [ ] - one of</span>
<span class="c1">// [^] - one not of</span>
<span class="c1">// - - range</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/\d/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s1">'0'</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'Digit'</span><span class="p">);</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/[0-9]/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s1">'6'</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'Digit'</span><span class="p">);</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/[13579]/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s1">'1'</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'Odd number'</span><span class="p">);</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/\S\S\s\S\S\S\S/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s1">'My name'</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'Format OK'</span><span class="p">);</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/\w\w\w/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s1">'Tom'</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'Hello Tom'</span><span class="p">);</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/[a-zA-Z]/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s1">'B'</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'Letter'</span><span class="p">);</span>
</pre></div>
<div class="mw-heading mw-heading4"><h4 id="Character_matching">Character matching</h4></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// A...Z a...z 0...9 - alphanumeric</span>
<span class="c1">// \u0000...\uFFFF - Unicode hexadecimal</span>
<span class="c1">// \x00...\xFF - ASCII hexadecimal</span>
<span class="c1">// \t - tab</span>
<span class="c1">// \n - new line</span>
<span class="c1">// \r - CR</span>
<span class="c1">// . - any character</span>
<span class="c1">// | - OR</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/T.m/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s1">'Tom'</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="w"> </span><span class="p">(</span><span class="s1">'Hi Tom, Tam or Tim'</span><span class="p">);</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/A|B/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"A"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="w"> </span><span class="p">(</span><span class="s1">'A or B'</span><span class="p">);</span>
</pre></div>
<div class="mw-heading mw-heading4"><h4 id="Repeaters">Repeaters</h4></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// ? - 0 or 1 match</span>
<span class="c1">// * - 0 or more</span>
<span class="c1">// + - 1 or more</span>
<span class="c1">// {n} - exactly n</span>
<span class="c1">// {n,} - n or more</span>
<span class="c1">// {0,n} - n or less</span>
<span class="c1">// {n,m} - range n to m</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/ab?c/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"ac"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"OK"</span><span class="p">);</span><span class="w"> </span><span class="c1">// match: "ac", "abc"</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/ab*c/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"ac"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"OK"</span><span class="p">);</span><span class="w"> </span><span class="c1">// match: "ac", "abc", "abbc", "abbbc" etc.</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/ab+c/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"abc"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"OK"</span><span class="p">);</span><span class="w"> </span><span class="c1">// match: "abc", "abbc", "abbbc" etc.</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/ab{3}c/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"abbbc"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"OK"</span><span class="p">);</span><span class="w"> </span><span class="c1">// match: "abbbc"</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/ab{3,}c/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"abbbc"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"OK"</span><span class="p">);</span><span class="w"> </span><span class="c1">// match: "abbbc", "abbbbc", "abbbbbc" etc.</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/ab{1,3}c/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"abc"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"OK"</span><span class="p">);</span><span class="w"> </span><span class="c1">// match: "abc", "abbc", "abbbc"</span>
</pre></div>
<div class="mw-heading mw-heading4"><h4 id="Anchors">Anchors</h4></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// ^ - string starts with</span>
<span class="c1">// $ - string ends with</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/^My/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"My name is Tom"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="w"> </span><span class="p">(</span><span class="s2">"Hi!"</span><span class="p">);</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/Tom$/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"My name is Tom"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="w"> </span><span class="p">(</span><span class="s2">"Hi Tom!"</span><span class="p">);</span>
</pre></div>
<div class="mw-heading mw-heading4"><h4 id="Subexpression">Subexpression</h4></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// ( ) - groups characters</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/water(mark)?/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"watermark"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"Here is water!"</span><span class="p">);</span><span class="w"> </span><span class="c1">// match: "water", "watermark",</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="sr">/(Tom)|(John)/</span><span class="p">.</span><span class="nx">test</span><span class="p">(</span><span class="s2">"John"</span><span class="p">))</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"Hi Tom or John!"</span><span class="p">);</span>
</pre></div>
<div class="mw-heading mw-heading4"><h4 id="Flags">Flags</h4></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// /g - global</span>
<span class="c1">// /i - ignore upper/lower case</span>
<span class="c1">// /m - allow matches to span multiple lines</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"hi tom!"</span><span class="p">.</span><span class="nx">replace</span><span class="p">(</span><span class="sr">/Tom/i</span><span class="p">,</span><span class="w"> </span><span class="s2">"John"</span><span class="p">));</span><span class="w"> </span><span class="c1">// == "hi John!"</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"ratatam"</span><span class="p">.</span><span class="nx">replace</span><span class="p">(</span><span class="sr">/ta/</span><span class="p">,</span><span class="w"> </span><span class="s2">"tu"</span><span class="p">));</span><span class="w"> </span><span class="c1">// == "ratutam"</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"ratatam"</span><span class="p">.</span><span class="nx">replace</span><span class="p">(</span><span class="sr">/ta/g</span><span class="p">,</span><span class="w"> </span><span class="s2">"tu"</span><span class="p">));</span><span class="w"> </span><span class="c1">// == "ratutum"</span>
</pre></div>
<div class="mw-heading mw-heading4"><h4 id="Advanced_methods">Advanced methods</h4></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">my_array</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">my_string</span><span class="p">.</span><span class="nx">split</span><span class="p">(</span><span class="nx">my_delimiter</span><span class="p">);</span>
<span class="c1">// example</span>
<span class="nx">my_array</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"dog,cat,cow"</span><span class="p">.</span><span class="nx">split</span><span class="p">(</span><span class="s2">","</span><span class="p">);</span><span class="w"> </span><span class="c1">// my_array==["dog","cat","cow"];</span>
<span class="nx">my_array</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">my_string</span><span class="p">.</span><span class="nx">match</span><span class="p">(</span><span class="nx">my_expression</span><span class="p">);</span>
<span class="c1">// example</span>
<span class="nx">my_array</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"We start at 11:30, 12:15 and 16:45"</span><span class="p">.</span><span class="nx">match</span><span class="p">(</span><span class="sr">/\d\d:\d\d/g</span><span class="p">);</span><span class="w"> </span><span class="c1">// my_array==["11:30","12:15","16:45"];</span>
</pre></div>
<div class="mw-heading mw-heading4"><h4 id="Capturing_groups">Capturing groups</h4></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">myRe</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="sr">/(\d{4}-\d{2}-\d{2}) (\d{2}:\d{2}:\d{2})/</span><span class="p">;</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">results</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">myRe</span><span class="p">.</span><span class="nx">exec</span><span class="p">(</span><span class="s2">"The date and time are 2009-09-08 09:37:08."</span><span class="p">);</span>
<span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="nx">results</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"Matched: "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">results</span><span class="p">[</span><span class="mf">0</span><span class="p">]);</span><span class="w"> </span><span class="c1">// Entire match</span>
<span class="w"> </span><span class="kd">const</span><span class="w"> </span><span class="nx">my_date</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">results</span><span class="p">[</span><span class="mf">1</span><span class="p">];</span><span class="w"> </span><span class="c1">// First group == "2009-09-08"</span>
<span class="w"> </span><span class="kd">const</span><span class="w"> </span><span class="nx">my_time</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">results</span><span class="p">[</span><span class="mf">2</span><span class="p">];</span><span class="w"> </span><span class="c1">// Second group == "09:37:08"</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="sb">`It is </span><span class="si">${</span><span class="nx">my_time</span><span class="si">}</span><span class="sb"> on </span><span class="si">${</span><span class="nx">my_date</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span>
<span class="p">}</span><span class="w"> </span><span class="k">else</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"Did not find a valid date!"</span><span class="p">);</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Function">Function</h3></div>
<p>Every function in JavaScript is an instance of the <code>Function</code> constructor:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// x, y is the argument. 'return x + y' is the function body, which is the last in the argument list.</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">add</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">Function</span><span class="p">(</span><span class="s1">'x'</span><span class="p">,</span><span class="w"> </span><span class="s1">'y'</span><span class="p">,</span><span class="w"> </span><span class="s1">'return x + y'</span><span class="p">);</span>
<span class="nx">add</span><span class="p">(</span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">);</span><span class="w"> </span><span class="c1">// => 3</span>
</pre></div>
<p>The add function above may also be defined using a function expression:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">add</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="p">(</span><span class="nx">x</span><span class="p">,</span><span class="w"> </span><span class="nx">y</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">y</span><span class="p">;</span>
<span class="p">};</span>
<span class="nx">add</span><span class="p">(</span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">);</span><span class="w"> </span><span class="c1">// => 3</span>
</pre></div>
<p>In ES6, arrow function syntax was added, allowing functions that return a value to be more concise. They also retain the <code>this</code> of the global object instead of inheriting it from where it was called / what it was called on, unlike the <code>function() {}</code> expression.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">add</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="nx">x</span><span class="p">,</span><span class="w"> </span><span class="nx">y</span><span class="p">)</span><span class="w"> </span><span class="p">=></span><span class="w"> </span><span class="p">{</span><span class="k">return</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">y</span><span class="p">;};</span>
<span class="c1">// values can also be implicitly returned (i.e. no return statement is needed)</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">addImplicit</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">(</span><span class="nx">x</span><span class="p">,</span><span class="w"> </span><span class="nx">y</span><span class="p">)</span><span class="w"> </span><span class="p">=></span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">y</span><span class="p">;</span>
<span class="nx">add</span><span class="p">(</span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">);</span><span class="w"> </span><span class="c1">// => 3</span>
<span class="nx">addImplicit</span><span class="p">(</span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">)</span><span class="w"> </span><span class="c1">// => 3</span>
</pre></div>
<p>For functions that need to be hoisted, there is a separate expression:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">function</span><span class="w"> </span><span class="nx">add</span><span class="p">(</span><span class="nx">x</span><span class="p">,</span><span class="w"> </span><span class="nx">y</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">y</span><span class="p">;</span>
<span class="p">}</span>
<span class="nx">add</span><span class="p">(</span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">);</span><span class="w"> </span><span class="c1">// => 3</span>
</pre></div>
<p>Hoisting allows users to use the function before it is "declared":
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">add</span><span class="p">(</span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">);</span><span class="w"> </span><span class="c1">// => 3, not a ReferenceError</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">add</span><span class="p">(</span><span class="nx">x</span><span class="p">,</span><span class="w"> </span><span class="nx">y</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">y</span><span class="p">;</span>
<span class="p">}</span>
</pre></div>
<p>A function instance has properties and methods.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">function</span><span class="w"> </span><span class="nx">subtract</span><span class="p">(</span><span class="nx">x</span><span class="p">,</span><span class="w"> </span><span class="nx">y</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="nx">y</span><span class="p">;</span>
<span class="p">}</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">subtract</span><span class="p">.</span><span class="nx">length</span><span class="p">);</span><span class="w"> </span><span class="c1">// => 2, arity of the function (number of arguments)</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">subtract</span><span class="p">.</span><span class="nx">toString</span><span class="p">());</span>
<span class="cm">/*</span>
<span class="cm">"function subtract(x, y) {</span>
<span class="cm"> return x - y;</span>
<span class="cm">}"</span>
<span class="cm">*/</span>
</pre></div>
<div class="mw-heading mw-heading2"><h2 id="Operators">Operators</h2></div>
<p>The '+' operator is <a href="Operator_overloading" title="Operator overloading">overloaded</a>: it is used for string concatenation and arithmetic addition. This may cause problems when inadvertently mixing strings and numbers. As a unary operator, it can convert a numeric string to a number.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// Concatenate 2 strings</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'He'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s1">'llo'</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays Hello</span>
<span class="c1">// Add two numbers</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="mf">2</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mf">6</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 8</span>
<span class="c1">// Adding a number and a string results in concatenation (from left to right)</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="mf">2</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s1">'2'</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 22</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'$'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mf">3</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mf">4</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays $34, but $7 may have been expected</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'$'</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="p">(</span><span class="mf">3</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mf">4</span><span class="p">));</span><span class="w"> </span><span class="c1">// displays $7</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="mf">3</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mf">4</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s1">'7'</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 77, numbers stay numbers until a string is added</span>
<span class="c1">// Convert a string to a number using the unary plus</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">+</span><span class="s1">'2'</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="mf">2</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays true</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">+</span><span class="s1">'Hello'</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays NaN</span>
</pre></div>
<p>Similarly, the '*' operator is overloaded: it can convert a string into a number.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="mf">2</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s1">'6'</span><span class="o">*</span><span class="mf">1</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 8</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="mf">3</span><span class="o">*</span><span class="s1">'7'</span><span class="p">);</span><span class="w"> </span><span class="c1">// 21</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'3'</span><span class="o">*</span><span class="s1">'7'</span><span class="p">);</span><span class="w"> </span><span class="c1">// 21</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'hello'</span><span class="o">*</span><span class="s1">'world'</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays NaN</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Arithmetic">Arithmetic</h3></div>
<p>JavaScript supports the following <b>binary arithmetic operators</b>:
</p>
<table class="wikitable">
<tbody><tr>
<td align="center"><code>+</code></td>
<td>addition
</td></tr>
<tr>
<td align="center"><code>-</code></td>
<td>subtraction
</td></tr>
<tr>
<td align="center"><code>*</code></td>
<td>multiplication
</td></tr>
<tr>
<td align="center"><code>/</code></td>
<td>division (returns a floating-point value)
</td></tr>
<tr>
<td align="center"><code>%</code></td>
<td>modulo (returns the remainder)
</td></tr>
<tr>
<td align="center"><code>**</code></td>
<td>exponentiation
</td></tr></tbody></table>
<p>JavaScript supports the following <b>unary arithmetic operators</b>:
</p>
<table class="wikitable">
<tbody><tr>
<td align="center"><code>+</code></td>
<td>unary conversion of string to number
</td></tr>
<tr>
<td align="center"><code>-</code></td>
<td>unary negation (reverses the sign)
</td></tr>
<tr>
<td align="center"><code>++</code></td>
<td>increment (can be prefix or postfix)
</td></tr>
<tr>
<td align="center"><code>--</code></td>
<td>decrement (can be prefix or postfix)
</td></tr></tbody></table>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">let</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">1</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">++</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// x becomes 2; displays 2</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="o">++</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 2; x becomes 3</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// x is 3; displays 3</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="o">--</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 3; x becomes 2</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 2; x is 2</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">--</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// x becomes 1; displays 1</span>
</pre></div>
<p>The modulo operator displays the remainder after division by the modulus. If negative numbers are involved, the returned value depends on the operand.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">17</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="o">%</span><span class="mf">5</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 2</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="o">%</span><span class="mf">6</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 5</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">-</span><span class="nx">x</span><span class="o">%</span><span class="mf">5</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays -2</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">-</span><span class="nx">x</span><span class="o">%-</span><span class="mf">5</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays -2</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="o">%-</span><span class="mf">5</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 2</span>
</pre></div>
<p>To always return a non-negative number, users can re-add the modulus and apply the modulo operator again:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">17</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">((</span><span class="o">-</span><span class="nx">x</span><span class="o">%</span><span class="mf">5</span><span class="o">+</span><span class="mf">5</span><span class="p">)</span><span class="o">%</span><span class="mf">5</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays 3</span>
</pre></div>
<p>Users could also do:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">17</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Math</span><span class="p">.</span><span class="nx">abs</span><span class="p">(</span><span class="o">-</span><span class="nx">x</span><span class="o">%</span><span class="mf">5</span><span class="p">));</span><span class="w"> </span><span class="c1">// also 3</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Assignment">Assignment</h3></div>
<table class="wikitable">
<tbody><tr>
<td align="center"><code>=</code></td>
<td>assign
</td></tr>
<tr>
<td align="center"><code>+=</code></td>
<td>add and assign
</td></tr>
<tr>
<td align="center"><code>-=</code></td>
<td>subtract and assign
</td></tr>
<tr>
<td align="center"><code>*=</code></td>
<td>multiply and assign
</td></tr>
<tr>
<td align="center"><code>/=</code></td>
<td>divide and assign
</td></tr>
<tr>
<td align="center"><code>%=</code></td>
<td>modulo and assign
</td></tr>
<tr>
<td align="center"><code>**=</code></td>
<td>exponentiation and assign
</td></tr></tbody></table>
<p><a href="Assignment_(computer_science)" title="Assignment (computer science)">Assignment</a> of <a href="Primitive_type" class="mw-redirect" title="Primitive type">primitive types</a>
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">let</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">9</span><span class="p">;</span>
<span class="nx">x</span><span class="w"> </span><span class="o">+=</span><span class="w"> </span><span class="mf">1</span><span class="p">;</span><span class="w"> </span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays: 10</span>
<span class="nx">x</span><span class="w"> </span><span class="o">*=</span><span class="w"> </span><span class="mf">30</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays: 300</span>
<span class="nx">x</span><span class="w"> </span><span class="o">/=</span><span class="w"> </span><span class="mf">6</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays: 50</span>
<span class="nx">x</span><span class="w"> </span><span class="o">-=</span><span class="w"> </span><span class="mf">3</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays: 47</span>
<span class="nx">x</span><span class="w"> </span><span class="o">%=</span><span class="w"> </span><span class="mf">7</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays: 5</span>
</pre></div>
<p>Assignment of object types
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="cm">/**</span>
<span class="cm"> * To learn JavaScript objects...</span>
<span class="cm"> */</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">object_1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="nx">a</span><span class="o">:</span><span class="w"> </span><span class="mf">1</span><span class="p">};</span><span class="w"> </span><span class="c1">// assign reference of newly created object to object_1</span>
<span class="kd">let</span><span class="w"> </span><span class="nx">object_2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="nx">a</span><span class="o">:</span><span class="w"> </span><span class="mf">0</span><span class="p">};</span>
<span class="kd">let</span><span class="w"> </span><span class="nx">object_3</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">object_2</span><span class="p">;</span><span class="w"> </span><span class="c1">// object_3 references the same object as object_2 does</span>
<span class="w"> </span>
<span class="nx">object_3</span><span class="p">.</span><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">2</span><span class="p">;</span>
<span class="nx">message</span><span class="p">();</span><span class="w"> </span><span class="c1">// displays 1 2 2</span>
<span class="w"> </span>
<span class="nx">object_2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">object_1</span><span class="p">;</span><span class="w"> </span><span class="c1">// object_2 now references the same object as object_1</span>
<span class="w"> </span><span class="c1">// object_3 still references what object_2 referenced before</span>
<span class="nx">message</span><span class="p">();</span><span class="w"> </span><span class="c1">// displays 1 1 2</span>
<span class="w"> </span>
<span class="nx">object_2</span><span class="p">.</span><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">7</span><span class="p">;</span><span class="w"> </span><span class="c1">// modifies object_1</span>
<span class="nx">message</span><span class="p">();</span><span class="w"> </span><span class="c1">// displays 7 7 2</span>
<span class="nx">object_3</span><span class="p">.</span><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">5</span><span class="p">;</span><span class="w"> </span><span class="c1">// object_3 does not change object_2</span>
<span class="nx">message</span><span class="p">();</span><span class="w"> </span><span class="c1">// displays 7 7 5</span>
<span class="nx">object_3</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">object_2</span><span class="p">;</span><span class="w"> </span>
<span class="nx">object_3</span><span class="p">.</span><span class="nx">a</span><span class="o">=</span><span class="mf">4</span><span class="p">;</span><span class="w"> </span><span class="c1">// object_3 changes object_1 and object_2</span>
<span class="nx">message</span><span class="p">();</span><span class="w"> </span><span class="c1">// displays 4 4 4</span>
<span class="cm">/**</span>
<span class="cm"> * Prints the console.log message</span>
<span class="cm"> */</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">message</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">object_1</span><span class="p">.</span><span class="nx">a</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s2">" "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">object_2</span><span class="p">.</span><span class="nx">a</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s2">" "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">object_3</span><span class="p">.</span><span class="nx">a</span><span class="p">);</span>
<span class="p">}</span>
</pre></div>
<div class="mw-heading mw-heading4"><h4 id="Destructuring_assignment">Destructuring assignment</h4></div>
<p>In Mozilla's JavaScript, since version 1.7, destructuring assignment allows the assignment of parts of data structures to several variables at once. The left hand side of an assignment is a pattern that resembles an arbitrarily nested object/array literal containing l-lvalues at its leaves that are to receive the substructures of the assigned value.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">let</span><span class="w"> </span><span class="nx">a</span><span class="p">,</span><span class="w"> </span><span class="nx">b</span><span class="p">,</span><span class="w"> </span><span class="nx">c</span><span class="p">,</span><span class="w"> </span><span class="nx">d</span><span class="p">,</span><span class="w"> </span><span class="nx">e</span><span class="p">;</span>
<span class="p">[</span><span class="nx">a</span><span class="p">,</span><span class="w"> </span><span class="nx">b</span><span class="p">,</span><span class="w"> </span><span class="nx">c</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="mf">3</span><span class="p">,</span><span class="w"> </span><span class="mf">4</span><span class="p">,</span><span class="w"> </span><span class="mf">5</span><span class="p">];</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="sb">`</span><span class="si">${</span><span class="nx">a</span><span class="si">}</span><span class="sb">,</span><span class="si">${</span><span class="nx">b</span><span class="si">}</span><span class="sb">,</span><span class="si">${</span><span class="nx">c</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays: 3,4,5</span>
<span class="nx">e</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="nx">foo</span><span class="o">:</span><span class="w"> </span><span class="mf">5</span><span class="p">,</span><span class="w"> </span><span class="nx">bar</span><span class="o">:</span><span class="w"> </span><span class="mf">6</span><span class="p">,</span><span class="w"> </span><span class="nx">baz</span><span class="o">:</span><span class="w"> </span><span class="p">[</span><span class="s1">'Baz'</span><span class="p">,</span><span class="w"> </span><span class="s1">'Content'</span><span class="p">]};</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">arr</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[];</span>
<span class="p">({</span><span class="nx">baz</span><span class="o">:</span><span class="w"> </span><span class="p">[</span><span class="nx">arr</span><span class="p">[</span><span class="mf">0</span><span class="p">],</span><span class="w"> </span><span class="nx">arr</span><span class="p">[</span><span class="mf">3</span><span class="p">]],</span><span class="w"> </span><span class="nx">foo</span><span class="o">:</span><span class="w"> </span><span class="nx">a</span><span class="p">,</span><span class="w"> </span><span class="nx">bar</span><span class="o">:</span><span class="w"> </span><span class="nx">b</span><span class="p">}</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">e</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="sb">`</span><span class="si">${</span><span class="nx">a</span><span class="si">}</span><span class="sb">,</span><span class="si">${</span><span class="nx">b</span><span class="si">}</span><span class="sb">,</span><span class="si">${</span><span class="nx">arr</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays: 5,6,Baz,,,Content</span>
<span class="p">[</span><span class="nx">a</span><span class="p">,</span><span class="w"> </span><span class="nx">b</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="nx">b</span><span class="p">,</span><span class="w"> </span><span class="nx">a</span><span class="p">];</span><span class="w"> </span><span class="c1">// swap contents of a and b</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">a</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s1">','</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">b</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays: 6,5</span>
<span class="p">[</span><span class="nx">a</span><span class="p">,</span><span class="w"> </span><span class="nx">b</span><span class="p">,</span><span class="w"> </span><span class="nx">c</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="mf">3</span><span class="p">,</span><span class="w"> </span><span class="mf">4</span><span class="p">,</span><span class="w"> </span><span class="mf">5</span><span class="p">];</span><span class="w"> </span><span class="c1">// permutations</span>
<span class="p">[</span><span class="nx">a</span><span class="p">,</span><span class="w"> </span><span class="nx">b</span><span class="p">,</span><span class="w"> </span><span class="nx">c</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="nx">b</span><span class="p">,</span><span class="w"> </span><span class="nx">c</span><span class="p">,</span><span class="w"> </span><span class="nx">a</span><span class="p">];</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="sb">`</span><span class="si">${</span><span class="nx">a</span><span class="si">}</span><span class="sb">,</span><span class="si">${</span><span class="nx">b</span><span class="si">}</span><span class="sb">,</span><span class="si">${</span><span class="nx">c</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span><span class="w"> </span><span class="c1">// displays: 4,5,3</span>
</pre></div>
<div class="mw-heading mw-heading4"><h4 id="Spread/rest_operator">Spread/rest operator</h4></div>
<p>The ECMAScript 2015 standard introduced the "<code>...</code>" array operator, for the related concepts of "spread syntax"<sup id="cite_ref-16" class="reference"><a href="#cite_note-16"><span class="cite-bracket">[</span>16<span class="cite-bracket">]</span></a></sup> and "rest parameters".<sup id="cite_ref-17" class="reference"><a href="#cite_note-17"><span class="cite-bracket">[</span>17<span class="cite-bracket">]</span></a></sup> Object spreading was added in ECMAScript 2018.
</p><p><b>Spread syntax</b> provides another way to destructure arrays and objects. For arrays, it indicates that the elements should be used as the parameters in a function call or the items in an array literal. For objects, it can be used for merging objects together or overriding properties.
</p><p>In other words, "<code>...</code>" transforms "<code>[...foo]</code>" into "<code>[foo[0], foo[1], foo[2]]</code>", and "<code>this.bar(...foo);</code>" into "<code>this.bar(foo[0], foo[1], foo[2]);</code>", and "<code>{ ...bar }</code>" into <code>{ prop: bar.prop, prop2: bar.prop2 }</code>.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr mw-highlight-lines" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">,</span><span class="w"> </span><span class="mf">3</span><span class="p">,</span><span class="w"> </span><span class="mf">4</span><span class="p">];</span>
<span class="c1">// It can be used multiple times in the same expression</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[...</span><span class="nx">a</span><span class="p">,</span><span class="w"> </span><span class="p">...</span><span class="nx">a</span><span class="p">];</span><span class="w"> </span><span class="c1">// b = [1, 2, 3, 4, 1, 2, 3, 4];</span>
<span class="c1">// It can be combined with non-spread items.</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">c</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="mf">5</span><span class="p">,</span><span class="w"> </span><span class="mf">6</span><span class="p">,</span><span class="w"> </span><span class="p">...</span><span class="nx">a</span><span class="p">,</span><span class="w"> </span><span class="mf">7</span><span class="p">,</span><span class="w"> </span><span class="mf">9</span><span class="p">];</span><span class="w"> </span><span class="c1">// c = [5, 6, 1, 2, 3, 4, 7, 9];</span>
<span class="c1">// For comparison, doing this without the spread operator </span>
<span class="c1">// creates a nested array.</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">d</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="nx">a</span><span class="p">,</span><span class="w"> </span><span class="nx">a</span><span class="p">];</span><span class="w"> </span><span class="c1">// d = [[1, 2, 3, 4], [1, 2, 3, 4]]</span>
<span class="c1">// It works the same with function calls</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">foo</span><span class="p">(</span><span class="nx">arg1</span><span class="p">,</span><span class="w"> </span><span class="nx">arg2</span><span class="p">,</span><span class="w"> </span><span class="nx">arg3</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="sb">`</span><span class="si">${</span><span class="nx">arg1</span><span class="si">}</span><span class="sb">:</span><span class="si">${</span><span class="nx">arg2</span><span class="si">}</span><span class="sb">:</span><span class="si">${</span><span class="nx">arg3</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span>
<span class="p">}</span>
<span class="c1">// Users can use it even if it passes more parameters than the function will use</span>
<span class="nx">foo</span><span class="p">(...</span><span class="nx">a</span><span class="p">);</span><span class="w"> </span><span class="c1">// "1:2:3" → foo(a[0], a[1], a[2], a[3]);</span>
<span class="c1">// Users can mix it with non-spread parameters</span>
<span class="nx">foo</span><span class="p">(</span><span class="mf">5</span><span class="p">,</span><span class="w"> </span><span class="p">...</span><span class="nx">a</span><span class="p">,</span><span class="w"> </span><span class="mf">6</span><span class="p">);</span><span class="w"> </span><span class="c1">// "5:1:2" → foo(5, a[0], a[1], a[2], a[3], 6);</span>
<span class="c1">// For comparison, doing this without the spread operator</span>
<span class="c1">// assigns the array to arg1, and nothing to the other parameters.</span>
<span class="nx">foo</span><span class="p">(</span><span class="nx">a</span><span class="p">);</span><span class="w"> </span><span class="c1">// "1,2,3,4:undefined:undefined"</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">bar</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">a</span><span class="o">:</span><span class="w"> </span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="nx">b</span><span class="o">:</span><span class="w"> </span><span class="mf">2</span><span class="p">,</span><span class="w"> </span><span class="nx">c</span><span class="o">:</span><span class="w"> </span><span class="mf">3</span><span class="w"> </span><span class="p">};</span>
<span class="c1">// This would copy the object</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">copy</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="nx">bar</span><span class="w"> </span><span class="p">};</span><span class="w"> </span><span class="c1">// copy = { a: 1, b: 2, c: 3 };</span>
<span class="c1">// "b" would be overridden here</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">override</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="nx">bar</span><span class="p">,</span><span class="w"> </span><span class="nx">b</span><span class="o">:</span><span class="w"> </span><span class="mf">4</span><span class="w"> </span><span class="p">};</span><span class="w"> </span><span class="c1">// override = { a: 1, c: 3, b: 4 }</span>
</pre></div>
<p>When <code>...</code> is used in a function <i>declaration</i>, it indicates a <b>rest parameter</b>. The rest parameter must be the final named parameter in the function's parameter list. It will be assigned an <code>Array</code> containing any arguments passed to the function in excess of the other named parameters. In other words, it gets "the rest" of the arguments passed to the function (hence the name).
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">function</span><span class="w"> </span><span class="nx">foo</span><span class="p">(</span><span class="nx">a</span><span class="p">,</span><span class="w"> </span><span class="nx">b</span><span class="p">,</span><span class="w"> </span><span class="p">...</span><span class="nx">c</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">c</span><span class="p">.</span><span class="nx">length</span><span class="p">);</span>
<span class="p">}</span>
<span class="nx">foo</span><span class="p">(</span><span class="mf">1</span><span class="p">,</span><span class="w"> </span><span class="mf">2</span><span class="p">,</span><span class="w"> </span><span class="mf">3</span><span class="p">,</span><span class="w"> </span><span class="mf">4</span><span class="p">,</span><span class="w"> </span><span class="mf">5</span><span class="p">);</span><span class="w"> </span><span class="c1">// "3" → c = [3, 4, 5]</span>
<span class="nx">foo</span><span class="p">(</span><span class="s1">'a'</span><span class="p">,</span><span class="w"> </span><span class="s1">'b'</span><span class="p">);</span><span class="w"> </span><span class="c1">// "0" → c = []</span>
</pre></div>
<p>Rest parameters are similar to Javascript's <code>arguments</code> object, which is an array-like object that contains all of the parameters (named and unnamed) in the current function call. Unlike <code>arguments</code>, however, rest parameters are true <code>Array</code> objects, so methods such as <code>.slice()</code> and <code>.sort()</code> can be used on them directly.
</p>
<div class="mw-heading mw-heading3"><h3 id="Comparison">Comparison</h3></div>
<table class="wikitable">
<tbody><tr>
<td align="center"><code>==</code></td>
<td>equal
</td></tr>
<tr>
<td align="center"><code>!=</code></td>
<td>not equal
</td></tr>
<tr>
<td align="center"><code>></code></td>
<td>greater than
</td></tr>
<tr>
<td align="center"><code>>=</code></td>
<td>greater than or equal to
</td></tr>
<tr>
<td align="center"><code><</code></td>
<td>less than
</td></tr>
<tr>
<td align="center"><code><=</code></td>
<td>less than or equal to
</td></tr>
<tr>
<td align="center"><code>===</code></td>
<td>identical (equal and of same type)
</td></tr>
<tr>
<td align="center"><code>!==</code></td>
<td>not identical
</td></tr></tbody></table>
<p>Variables referencing objects are equal or identical only if they reference the same object:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">obj1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="nx">a</span><span class="o">:</span><span class="w"> </span><span class="mf">1</span><span class="p">};</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">obj2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="nx">a</span><span class="o">:</span><span class="w"> </span><span class="mf">1</span><span class="p">};</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">obj3</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">obj1</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">obj1</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="nx">obj2</span><span class="p">);</span><span class="w"> </span><span class="c1">//false</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">obj3</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="nx">obj1</span><span class="p">);</span><span class="w"> </span><span class="c1">//true</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">obj3</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nx">obj1</span><span class="p">);</span><span class="w"> </span><span class="c1">//true</span>
</pre></div>
<p>See also <a href="#String">String</a>.
</p>
<div class="mw-heading mw-heading3"><h3 id="Logical">Logical</h3></div>
<p>JavaScript provides four logical operators:
</p>
<ul><li>unary <a href="Negation" title="Negation">negation</a> (<code>NOT = !a</code>)</li>
<li>binary <a href="Logical_disjunction" title="Logical disjunction">disjunction</a> (<code>OR = a || b</code>) and <a href="Logical_conjunction" title="Logical conjunction">conjunction</a> (<code>AND = a && b</code>)</li>
<li>ternary <a href="Conditional_(programming)" class="mw-redirect" title="Conditional (programming)">conditional</a> (<code>c ? t : f</code>)</li></ul>
<p>In the context of a logical operation, any expression evaluates to true except the following<b>:</b>
</p>
<ul><li>Strings: <code>""</code>, <code>''</code>,</li>
<li>Numbers: <code>0</code>, <code>-0</code>, <code>NaN</code>,</li>
<li>Special: <code>null</code>, <code>undefined</code>,</li>
<li>Boolean: <code>false</code>.</li></ul>
<p>The Boolean function can be used to explicitly convert to a primitive of type <code>Boolean</code>:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// Only empty strings return false</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="s2">""</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="s2">"false"</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">true</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="s2">"0"</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">true</span><span class="p">);</span>
<span class="c1">// Only zero and NaN return false</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="kc">NaN</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="mf">0</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="o">-</span><span class="mf">0</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// equivalent to -1*0</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="o">-</span><span class="mf">2</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">true</span><span class="p">);</span>
<span class="c1">// All objects return true</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="k">this</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">true</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">({})</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">true</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">([])</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">true</span><span class="p">);</span>
<span class="c1">// These types return false</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="kc">null</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="kc">undefined</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// equivalent to Boolean()</span>
</pre></div>
<p>The NOT operator evaluates its operand as a Boolean and returns the negation. Using the operator twice in a row, as a <a href="Double_negative" title="Double negative">double negative</a>, explicitly converts an expression to a primitive of type Boolean:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="w"> </span><span class="o">!</span><span class="mf">0</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="o">!</span><span class="mf">0</span><span class="p">));</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="o">!</span><span class="mf">0</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="o">!!</span><span class="mf">1</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">!!</span><span class="mf">1</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="mf">1</span><span class="p">));</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">!!</span><span class="mf">0</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="mf">0</span><span class="p">));</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="mf">0</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="o">!</span><span class="mf">1</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">!</span><span class="mf">1</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="o">!</span><span class="mf">1</span><span class="p">));</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">!</span><span class="s2">""</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="o">!</span><span class="s2">""</span><span class="p">));</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="o">!</span><span class="s2">""</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="o">!!</span><span class="s2">"s"</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">!!</span><span class="s2">"s"</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="s2">"s"</span><span class="p">));</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">!!</span><span class="s2">""</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="s2">""</span><span class="p">));</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nb">Boolean</span><span class="p">(</span><span class="s2">""</span><span class="p">)</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="o">!</span><span class="s2">"s"</span><span class="p">);</span><span class="w"> </span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="o">!</span><span class="s2">"s"</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="nb">Boolean</span><span class="p">(</span><span class="o">!</span><span class="s2">"s"</span><span class="p">));</span>
</pre></div>
<p>The ternary operator can also be used for explicit conversion:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">([]</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">([]</span><span class="w"> </span><span class="o">?</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// “truthy”, but the comparison uses [].toString()</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">([</span><span class="mf">0</span><span class="p">]</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">([</span><span class="mf">0</span><span class="p">]</span><span class="o">?</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// [0].toString() == "0"</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"0"</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"0"</span><span class="o">?</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// "0" → 0 ... (0 == 0) ... 0 ← false</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">([</span><span class="mf">1</span><span class="p">]</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="kc">true</span><span class="p">);</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">([</span><span class="mf">1</span><span class="p">]</span><span class="o">?</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// [1].toString() == "1"</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"1"</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="kc">true</span><span class="p">);</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"1"</span><span class="o">?</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// "1" → 1 ... (1 == 1) ... 1 ← true</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">([</span><span class="mf">2</span><span class="p">]</span><span class="w"> </span><span class="o">!=</span><span class="w"> </span><span class="kc">true</span><span class="p">);</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">([</span><span class="mf">2</span><span class="p">]</span><span class="o">?</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// [2].toString() == "2"</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"2"</span><span class="w"> </span><span class="o">!=</span><span class="w"> </span><span class="kc">true</span><span class="p">);</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"2"</span><span class="o">?</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="kc">false</span><span class="p">);</span><span class="w"> </span><span class="c1">// "2" → 2 ... (2 != 1) ... 1 ← true</span>
</pre></div>
<p>Expressions that use features such as post–incrementation (<code>i++</code>) have an anticipated <a href="Side_effect_(computer_science)" title="Side effect (computer science)">side effect</a>. JavaScript provides <a href="Short-circuit_evaluation" title="Short-circuit evaluation">short-circuit evaluation</a> of expressions; the right operand is only executed if the left operand does not suffice to determine the value of the expression.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">a</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="nx">b</span><span class="p">);</span><span class="w"> </span><span class="c1">// When a is true, there is no reason to evaluate b.</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">a</span><span class="w"> </span><span class="o">&&</span><span class="w"> </span><span class="nx">b</span><span class="p">);</span><span class="w"> </span><span class="c1">// When a is false, there is no reason to evaluate b.</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">c</span><span class="w"> </span><span class="o">?</span><span class="w"> </span><span class="nx">t</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="nx">f</span><span class="p">);</span><span class="w"> </span><span class="c1">// When c is true, there is no reason to evaluate f.</span>
</pre></div>
<p>In early versions of JavaScript and <a href="JScript" title="JScript">JScript</a>, the binary logical operators returned a Boolean value (like most C-derived programming languages). However, all contemporary implementations return one of their operands instead:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">a</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="nx">b</span><span class="p">);</span><span class="w"> </span><span class="c1">// if a is true, return a, otherwise return b</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">a</span><span class="w"> </span><span class="o">&&</span><span class="w"> </span><span class="nx">b</span><span class="p">);</span><span class="w"> </span><span class="c1">// if a is false, return a, otherwise return b</span>
</pre></div>
<p>Programmers who are more familiar with the behavior in C might find this feature surprising, but it allows for a more concise expression of patterns like <a href="Null_coalescing_operator" title="Null coalescing operator">null coalescing</a>:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">s</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">t</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="s2">"(default)"</span><span class="p">;</span><span class="w"> </span><span class="c1">// assigns t, or the default value, if t is null, empty, etc.</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Logical_assignment">Logical assignment</h3></div>
<table class="wikitable">
<tbody><tr>
<td align="center"><code>??=</code>
</td>
<td>Nullish assignment
</td></tr>
<tr>
<td align="center"><code>||=</code>
</td>
<td>Logical Or assignment
</td></tr>
<tr>
<td align="center"><code>&&=</code>
</td>
<td>Logical And assignment
</td></tr></tbody></table>
<div class="mw-heading mw-heading3"><h3 id="Bitwise">Bitwise</h3></div>
<p>JavaScript supports the following <b>binary <a href="Bitwise_operation" title="Bitwise operation">bitwise operators</a></b>:
</p>
<table class="wikitable">
<tbody><tr>
<td align="center"><code>&</code></td>
<td>AND
</td></tr>
<tr>
<td align="center"><code>|</code></td>
<td>OR
</td></tr>
<tr>
<td align="center"><code>^</code></td>
<td>XOR
</td></tr>
<tr>
<td align="center"><code>!</code></td>
<td>NOT
</td></tr>
<tr>
<td align="center"><code><<</code></td>
<td>shift left (zero fill at right)
</td></tr>
<tr>
<td align="center"><code>>></code></td>
<td>shift right (sign-propagating); copies of the<br>leftmost bit (sign bit) are shifted in from the left
</td></tr>
<tr>
<td align="center"><code>>>></code></td>
<td>shift right (zero fill at left). For positive numbers,<br><code>>></code> and <code>>>></code> yield the same result.
</td></tr></tbody></table>
<p>Examples:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">11</span><span class="w"> </span><span class="o">&</span><span class="w"> </span><span class="mf">6</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// 2</span>
</pre></div>
<p>JavaScript supports the following <b>unary bitwise operator</b>:
</p>
<table class="wikitable">
<tbody><tr>
<td align="center"><code>~</code></td>
<td>NOT (inverts the bits)
</td></tr></tbody></table>
<div class="mw-heading mw-heading3"><h3 id="Bitwise_Assignment">Bitwise Assignment</h3></div>
<p>JavaScript supports the following <b>binary assignment operators:</b>
</p>
<table class="wikitable">
<tbody><tr>
<td align="center"><code>&=</code></td>
<td>and
</td></tr>
<tr>
<td align="center"><code>|=</code></td>
<td>or
</td></tr>
<tr>
<td align="center"><code>^=</code></td>
<td>xor
</td></tr>
<tr>
<td align="center"><code><<=</code></td>
<td>shift left (zero fill at right)
</td></tr>
<tr>
<td align="center"><code>>>=</code></td>
<td>shift right (sign-propagating); copies of the<br>leftmost bit (sign bit) are shifted in from the left
</td></tr>
<tr>
<td align="center"><code>>>>=</code></td>
<td>shift right (zero fill at left). For positive numbers,<br><code>>>=</code> and <code>>>>=</code> yield the same result.
</td></tr></tbody></table>
<p>Examples:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">let</span><span class="w"> </span><span class="nx">x</span><span class="o">=</span><span class="mf">7</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// 7</span>
<span class="nx">x</span><span class="o"><<=</span><span class="mf">3</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="p">);</span><span class="w"> </span><span class="c1">// 7->14->28->56</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="String_2">String</h3></div>
<table class="wikitable">
<tbody><tr>
<td align="center"><code>=</code></td>
<td>assignment
</td></tr>
<tr>
<td align="center"><code>+</code></td>
<td>concatenation
</td></tr>
<tr>
<td align="center"><code>+=</code></td>
<td>concatenate and assign
</td></tr></tbody></table>
<p>Examples:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">let</span><span class="w"> </span><span class="nx">str</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"ab"</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s2">"cd"</span><span class="p">;</span><span class="w"> </span><span class="c1">// "abcd"</span>
<span class="nx">str</span><span class="w"> </span><span class="o">+=</span><span class="w"> </span><span class="s2">"e"</span><span class="p">;</span><span class="w"> </span><span class="c1">// "abcde"</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">str2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"2"</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="mf">2</span><span class="p">;</span><span class="w"> </span><span class="c1">// "22", not "4" or 4.</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="??">??</h3></div>
<div class="excerpt-block"><style data-mw-deduplicate="TemplateStyles:r1066933788">
/* start https://en.wikipedia.org/ */
.mw-parser-output .excerpt-hat .mw-editsection-like{font-style:normal}
/* end https://en.wikipedia.org/ */
</style><div role="note" class="hatnote navigation-not-searchable dablink excerpt-hat selfref">This section is an excerpt from <a href="Null_coalescing_operator#JavaScript" title="Null coalescing operator">Null coalescing operator § JavaScript</a>.<span class="mw-editsection-like "><span class="mw-editsection-bracket">[</span><a class="external text external" href="https://en.wikipedia.org/w/index.php?title=Null_coalescing_operator&action=edit">edit</a><span class="mw-editsection-bracket">]</span></span></div><div class="excerpt">
<p><a href="JavaScript" title="JavaScript">JavaScript</a>'s nearest operator is <code>??</code>, the "nullish coalescing operator", which was added to the standard in <a href="ECMAScript" title="ECMAScript">ECMAScript</a>'s 11th edition.<sup id="cite_ref-18" class="reference"><a href="#cite_note-18"><span class="cite-bracket">[</span>18<span class="cite-bracket">]</span></a></sup> In earlier versions, it could be used via a <a href="Babel_(compiler)" class="mw-redirect" title="Babel (compiler)">Babel</a> plugin, and in <a href="TypeScript" title="TypeScript">TypeScript</a>. It evaluates its left-hand operand and, if the result value is <i>not</i> "nullish" (<code>null</code> or <code>undefined</code>), takes that value as its result; otherwise, it evaluates the right-hand operand and takes the resulting value as its result.
</p><p>In the following example, <code>a</code> will be assigned the value of <code>b</code> if the value of <code>b</code> is not <code>null</code> or <code>undefined</code>, otherwise it will be assigned 3.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o">??</span><span class="w"> </span><span class="mf">3</span><span class="p">;</span>
</pre></div>
<p>Before the nullish coalescing operator, programmers would use the logical OR operator (<code>||</code>). But where <code>??</code> looks specifically for <code>null</code> or <code>undefined</code>, the <code>||</code> operator looks for any <a class="mw-selflink-fragment" href="#Boolean">falsy</a> value: <code>null</code>, <code>undefined</code>, <code>""</code>, <code>0</code>, <code>NaN</code>, and of course, <code>false</code>.
</p><p>In the following example, <code>a</code> will be assigned the value of <code>b</code> if the value of <code>b</code> is <a class="mw-selflink-fragment" href="#Boolean">truthy</a>, otherwise it will be assigned 3.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="mf">3</span><span class="p">;</span>
</pre></div></div></div>
<div class="mw-heading mw-heading2"><h2 id="Control_structures">Control structures</h2></div>
<div class="mw-heading mw-heading3"><h3 id="Compound_statements">Compound statements</h3></div>
<p>A pair of curly brackets <code>{ }</code> and an enclosed sequence of statements constitute a compound statement, which can be used wherever a statement can be used.
</p>
<div class="mw-heading mw-heading3"><h3 id="If_..._else">If ... else</h3></div>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="nx">expr</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="c1">//statements;</span>
<span class="p">}</span><span class="w"> </span><span class="k">else</span><span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="nx">expr2</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="c1">//statements;</span>
<span class="p">}</span><span class="w"> </span><span class="k">else</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="c1">//statements;</span>
<span class="p">}</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Conditional_(ternary)_operator">Conditional (ternary) operator</h3></div>
<p>The conditional operator creates an expression that evaluates as one of two expressions depending on a condition. This is similar to the <i>if</i> statement that selects one of two statements to execute depending on a condition. I.e., the conditional operator is to expressions what <i>if</i> is to statements.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">condition</span><span class="w"> </span><span class="o">?</span><span class="w"> </span><span class="nx">expression</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="nx">alternative</span><span class="p">;</span>
</pre></div>
<p>is the same as:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="nx">condition</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kd">const</span><span class="w"> </span><span class="nx">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">expression</span><span class="p">;</span>
<span class="p">}</span><span class="w"> </span><span class="k">else</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kd">const</span><span class="w"> </span><span class="nx">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">alternative</span><span class="p">;</span>
<span class="p">}</span>
</pre></div>
<p>Unlike the <i>if</i> statement, the conditional operator cannot omit its "else-branch".
</p>
<div class="mw-heading mw-heading3"><h3 id="Switch_statement">Switch statement</h3></div>
<p>The syntax of the JavaScript <a href="Control_flow#Choice" title="Control flow">switch statement</a> is as follows:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="w"> </span><span class="k">switch</span><span class="w"> </span><span class="p">(</span><span class="nx">expr</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">case</span><span class="w"> </span><span class="nx">SOMEVALUE</span><span class="o">:</span>
<span class="w"> </span><span class="c1">// statements;</span>
<span class="w"> </span><span class="k">break</span><span class="p">;</span>
<span class="w"> </span><span class="k">case</span><span class="w"> </span><span class="nx">ANOTHERVALUE</span><span class="o">:</span>
<span class="w"> </span><span class="c1">// statements for when ANOTHERVALUE || ORNAOTHERONE</span>
<span class="w"> </span><span class="c1">// no break statement, falling through to the following case</span>
<span class="w"> </span><span class="k">case</span><span class="w"> </span><span class="nx">ORANOTHERONE</span><span class="o">:</span>
<span class="w"> </span><span class="c1">// statements specific to ORANOTHERONE (i.e. !ANOTHERVALUE && ORANOTHER);</span>
<span class="w"> </span><span class="k">break</span><span class="p">;</span><span class="w"> </span><span class="c1">//The buck stops here.</span>
<span class="w"> </span><span class="k">case</span><span class="w"> </span><span class="nx">YETANOTHER</span><span class="o">:</span>
<span class="w"> </span><span class="c1">// statements;</span>
<span class="w"> </span><span class="k">break</span><span class="p">;</span>
<span class="w"> </span><span class="k">default</span><span class="o">:</span>
<span class="w"> </span><span class="c1">// statements;</span>
<span class="w"> </span><span class="k">break</span><span class="p">;</span>
<span class="w"> </span><span class="p">}</span>
</pre></div>
<ul><li><code>break;</code> is optional; however, it is usually needed, since otherwise code execution will continue to the body of the next case block. This <i>fall through</i> behavior can be used when the same set of statements apply in several cases, effectively creating a <a href="Disjunction" class="mw-redirect" title="Disjunction">disjunction</a> between those cases.</li>
<li>Add a break statement to the end of the last case as a precautionary measure, in case additional cases are added later.</li>
<li>String literal values can also be used for the case values.</li>
<li>Expressions can be used instead of values.</li>
<li>The default case (optional) is executed when the expression does not match any other specified cases.</li>
<li>Braces are required.</li></ul>
<div class="mw-heading mw-heading3"><h3 id="For_loop">For loop</h3></div>
<p>The syntax of the JavaScript <a href="For_loop" title="For loop">for loop</a> is as follows:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="w"> </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="nx">initial</span><span class="p">;</span><span class="w"> </span><span class="nx">condition</span><span class="p">;</span><span class="w"> </span><span class="nx">loop</span><span class="w"> </span><span class="nx">statement</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="cm">/*</span>
<span class="cm"> statements will be executed every time</span>
<span class="cm"> the for{} loop cycles, while the</span>
<span class="cm"> condition is satisfied</span>
<span class="cm"> */</span>
<span class="w"> </span><span class="p">}</span>
</pre></div>
<p>or
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="w"> </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="nx">initial</span><span class="p">;</span><span class="w"> </span><span class="nx">condition</span><span class="p">;</span><span class="w"> </span><span class="nx">loop</span><span class="w"> </span><span class="nx">statement</span><span class="p">(</span><span class="nx">iteration</span><span class="p">))</span><span class="w"> </span><span class="c1">// one statement</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="For_..._in_loop">For ... in loop</h3></div>
<p>The syntax of the JavaScript <code><a href="Foreach_loop" title="Foreach loop">for ... in loop</a></code> is as follows:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kd">var</span><span class="w"> </span><span class="nx">property_name</span><span class="w"> </span><span class="ow">in</span><span class="w"> </span><span class="nx">some_object</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="c1">// statements using some_object[property_name];</span>
<span class="p">}</span>
</pre></div>
<ul><li>Iterates through all enumerable properties of an object.</li>
<li>Iterates through all used indices of array including all user-defined properties of array object, if any. Thus it may be better to use a traditional for loop with a numeric index when iterating over arrays.</li>
<li>There are differences between the various Web browsers with regard to which properties will be reflected with the for...in loop statement. In theory, this is controlled by an internal state property defined by the ECMAscript standard called "DontEnum", but in practice, each browser returns a slightly different set of properties during introspection. It is useful to test for a given property using <span class="nowrap"><code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="nx">some_object</span><span class="p">.</span><span class="nx">hasOwnProperty</span><span class="p">(</span><span class="nx">property_name</span><span class="p">))</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">}</span></code></span>. Thus, adding a method to the array prototype with <span class="nowrap"><code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="nb">Array</span><span class="p">.</span><span class="nx">prototype</span><span class="p">.</span><span class="nx">newMethod</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="p">()</span><span class="w"> </span><span class="p">{...}</span></code></span> may cause <code>for ... in</code> loops to loop over the method's name.</li></ul>
<div class="mw-heading mw-heading3"><h3 id="While_loop">While loop</h3></div>
<p>The syntax of the JavaScript <a href="While_loop" title="While loop">while loop</a> is as follows:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">while</span><span class="w"> </span><span class="p">(</span><span class="nx">condition</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">statement1</span><span class="p">;</span>
<span class="w"> </span><span class="nx">statement2</span><span class="p">;</span>
<span class="w"> </span><span class="nx">statement3</span><span class="p">;</span>
<span class="w"> </span><span class="p">...</span>
<span class="p">}</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Do_..._while_loop">Do ... while loop</h3></div>
<p>The syntax of the JavaScript <code><a href="Do_while_loop" title="Do while loop">do ... while loop</a></code> is as follows:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">do</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">statement1</span><span class="p">;</span>
<span class="w"> </span><span class="nx">statement2</span><span class="p">;</span>
<span class="w"> </span><span class="nx">statement3</span><span class="p">;</span>
<span class="w"> </span><span class="p">...</span>
<span class="p">}</span><span class="w"> </span><span class="k">while</span><span class="w"> </span><span class="p">(</span><span class="nx">condition</span><span class="p">);</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="With">With</h3></div>
<p>The with statement adds all of the given object's properties and methods into the following block's scope, letting them be referenced as if they were local variables.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">with</span><span class="w"> </span><span class="p">(</span><span class="nb">document</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kd">const</span><span class="w"> </span><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">'a'</span><span class="p">);</span>
<span class="w"> </span><span class="kd">const</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">'b'</span><span class="p">);</span>
<span class="w"> </span><span class="kd">const</span><span class="w"> </span><span class="nx">c</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">getElementById</span><span class="p">(</span><span class="s1">'c'</span><span class="p">);</span>
<span class="p">};</span>
</pre></div>
<ul><li>Note the absence of <span class="monospaced">document.</span> before each <span class="monospaced">getElementById()</span> invocation.</li></ul>
<p>The semantics are similar to the with statement of <a href="Pascal_(programming_language)" title="Pascal (programming language)">Pascal</a>.
</p><p>Because the availability of with statements hinders program performance and is believed to reduce code clarity (since any given variable could actually be a property from an enclosing <span class="monospaced">with</span>), this statement is not allowed in <i>strict mode</i>.
</p>
<div class="mw-heading mw-heading3"><h3 id="Labels">Labels</h3></div>
<p>JavaScript supports nested labels in most implementations. Loops or blocks can be labeled for the break statement, and loops for <code>continue</code>. Although <code><a href="Goto" title="Goto">goto</a></code> is a reserved word,<sup id="cite_ref-19" class="reference"><a href="#cite_note-19"><span class="cite-bracket">[</span>19<span class="cite-bracket">]</span></a></sup> <code>goto</code> is not implemented in JavaScript.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">loop1</span><span class="o">:</span><span class="w"> </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kd">let</span><span class="w"> </span><span class="nx">a</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">0</span><span class="p">;</span><span class="w"> </span><span class="nx">a</span><span class="w"> </span><span class="o"><</span><span class="w"> </span><span class="mf">10</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="nx">a</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="nx">a</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="mf">4</span><span class="p">)</span><span class="w"> </span><span class="k">break</span><span class="w"> </span><span class="nx">loop1</span><span class="p">;</span><span class="w"> </span><span class="c1">// Stops after the 4th attempt</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'a = '</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">a</span><span class="p">);</span>
<span class="w"> </span><span class="nx">loop2</span><span class="o">:</span><span class="w"> </span><span class="k">for</span><span class="w"> </span><span class="p">(</span><span class="kd">let</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">0</span><span class="p">;</span><span class="w"> </span><span class="nx">b</span><span class="w"> </span><span class="o"><</span><span class="w"> </span><span class="mf">10</span><span class="p">;</span><span class="w"> </span><span class="o">++</span><span class="nx">b</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="nx">b</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="mf">3</span><span class="p">)</span><span class="w"> </span><span class="k">continue</span><span class="w"> </span><span class="nx">loop2</span><span class="p">;</span><span class="w"> </span><span class="c1">// Number 3 is skipped</span>
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="nx">b</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="mf">6</span><span class="p">)</span><span class="w"> </span><span class="k">continue</span><span class="w"> </span><span class="nx">loop1</span><span class="p">;</span><span class="w"> </span><span class="c1">// Continues the first loop, 'finished' is not shown</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'b = '</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">b</span><span class="p">);</span>
<span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="c1">//end of loop2</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'finished'</span><span class="p">);</span>
<span class="p">}</span><span class="w"> </span><span class="c1">//end of loop1</span>
<span class="nx">block1</span><span class="o">:</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'Hello'</span><span class="p">);</span><span class="w"> </span><span class="c1">// Displays 'Hello'</span>
<span class="w"> </span><span class="k">break</span><span class="w"> </span><span class="nx">block1</span><span class="p">;</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s1">'World'</span><span class="p">);</span><span class="w"> </span><span class="c1">// Will never get here</span>
<span class="p">}</span>
<span class="kr">goto</span><span class="w"> </span><span class="nx">block1</span><span class="p">;</span><span class="w"> </span><span class="c1">// Parse error.</span>
</pre></div>
<div class="mw-heading mw-heading2"><h2 id="Functions">Functions</h2></div>
<div role="note" class="hatnote navigation-not-searchable">Main article: <a href="Function_(computer_programming)" title="Function (computer programming)">Function (computer programming)</a></div>
<p>A <a href="Function_(computer_programming)" title="Function (computer programming)">function</a> is a block with a (possibly empty) parameter list that is normally given a name. A function may use local variables. If a user exits the function without a return statement, the value <span class="monospaced">undefined</span> is returned.
</p>
<div class="mw-highlight mw-highlight-lang-javascript+genshitext mw-content-ltr" dir="ltr"><pre><span class="kd">function</span><span class="w"> </span><span class="nx">gcd</span><span class="p">(</span><span class="nx">number1</span><span class="p">,</span><span class="w"> </span><span class="nx">number2</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="nb">isNaN</span><span class="p">(</span><span class="nx">number1</span><span class="o">*</span><span class="nx">number2</span><span class="p">))</span><span class="w"> </span><span class="k">throw</span><span class="w"> </span><span class="ne">TypeError</span><span class="p">(</span><span class="s2">"Non-Numeric arguments not allowed."</span><span class="p">);</span>
<span class="w"> </span><span class="nx">number1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">Math</span><span class="p">.</span><span class="nx">round</span><span class="p">(</span><span class="nx">number1</span><span class="p">);</span>
<span class="w"> </span><span class="nx">number2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">Math</span><span class="p">.</span><span class="nx">round</span><span class="p">(</span><span class="nx">number2</span><span class="p">);</span>
<span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nx">difference</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">number1</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="nx">number2</span><span class="p">;</span>
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="nx">difference</span><span class="w"> </span><span class="o">===</span><span class="w"> </span><span class="mf">0</span><span class="p">)</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">number1</span><span class="p">;</span>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">difference</span><span class="w"> </span><span class="o">></span><span class="w"> </span><span class="mf">0</span><span class="w"> </span><span class="o">?</span><span class="w"> </span><span class="nx">gcd</span><span class="p">(</span><span class="nx">number2</span><span class="p">,</span><span class="w"> </span><span class="nx">difference</span><span class="p">)</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="nx">gcd</span><span class="p">(</span><span class="nx">number1</span><span class="p">,</span><span class="w"> </span><span class="o">-</span><span class="nx">difference</span><span class="p">);</span>
<span class="p">}</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">gcd</span><span class="p">(</span><span class="mf">60</span><span class="p">,</span><span class="w"> </span><span class="mf">40</span><span class="p">));</span><span class="w"> </span><span class="c1">// 20</span>
<span class="c1">//In the absence of parentheses following the identifier 'gcd' on the RHS of the assignment below,</span>
<span class="c1">//'gcd' returns a reference to the function itself without invoking it.</span>
<span class="kd">let</span><span class="w"> </span><span class="nx">mygcd</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">gcd</span><span class="p">;</span><span class="w"> </span><span class="c1">// mygcd and gcd reference the same function.</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">mygcd</span><span class="p">(</span><span class="mf">60</span><span class="p">,</span><span class="w"> </span><span class="mf">40</span><span class="p">));</span><span class="w"> </span><span class="c1">// 20</span>
</pre></div>
<p>Functions are <a href="First_class_object" class="mw-redirect" title="First class object">first class objects</a> and may be assigned to other variables.
</p><p>The number of arguments given when calling a function may not necessarily correspond to the number of arguments in the function definition; a named argument in the definition that does not have a matching argument in the call will have the value <span class="monospaced">undefined</span> (that can be implicitly cast to false). Within the function, the arguments may also be accessed through the <span class="monospaced">arguments</span> object; this provides access to all arguments using indices (e.g. <code class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" style="" dir="ltr"><span class="nx">arguments</span><span class="p">[</span><span class="mf">0</span><span class="p">],</span><span class="w"> </span><span class="nx">arguments</span><span class="p">[</span><span class="mf">1</span><span class="p">],</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="nx">arguments</span><span class="p">[</span><span class="nx">n</span><span class="p">]</span></code>), including those beyond the number of named arguments. (While the arguments list has a <code>.length</code> property, it is <i>not</i> an instance of <span class="monospaced">Array</span>; it does not have methods such as <span class="monospaced">.slice()</span>, <span class="monospaced">.sort()</span>, etc.)
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">function</span><span class="w"> </span><span class="nx">add7</span><span class="p">(</span><span class="nx">x</span><span class="p">,</span><span class="w"> </span><span class="nx">y</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="nx">y</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">y</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">7</span><span class="p">;</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">x</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">y</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">arguments</span><span class="p">.</span><span class="nx">length</span><span class="p">);</span>
<span class="p">};</span>
<span class="nx">add7</span><span class="p">(</span><span class="mf">3</span><span class="p">);</span><span class="w"> </span><span class="c1">// 11</span>
<span class="nx">add7</span><span class="p">(</span><span class="mf">3</span><span class="p">,</span><span class="w"> </span><span class="mf">4</span><span class="p">);</span><span class="w"> </span><span class="c1">// 9</span>
</pre></div>
<p>Primitive values (number, boolean, string) are passed by value. For objects, it is the reference to the object that is passed.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">obj1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="nx">a</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="mf">1</span><span class="p">};</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">obj2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="nx">b</span><span class="w"> </span><span class="o">:</span><span class="w"> </span><span class="mf">2</span><span class="p">};</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">foo</span><span class="p">(</span><span class="nx">p</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">p</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">obj2</span><span class="p">;</span><span class="w"> </span><span class="c1">// Ignores actual parameter</span>
<span class="w"> </span><span class="nx">p</span><span class="p">.</span><span class="nx">b</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">arguments</span><span class="p">[</span><span class="mf">1</span><span class="p">];</span>
<span class="p">}</span>
<span class="nx">foo</span><span class="p">(</span><span class="nx">obj1</span><span class="p">,</span><span class="w"> </span><span class="mf">3</span><span class="p">);</span><span class="w"> </span><span class="c1">// Does not affect obj1 at all. 3 is additional parameter</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="sb">`</span><span class="si">${</span><span class="nx">obj1</span><span class="p">.</span><span class="nx">a</span><span class="si">}</span><span class="sb"> </span><span class="si">${</span><span class="nx">obj2</span><span class="p">.</span><span class="nx">b</span><span class="si">}</span><span class="sb">`</span><span class="p">);</span><span class="w"> </span><span class="c1">// writes 1 3</span>
</pre></div>
<p>Functions can be declared inside other functions, and access the outer function's local variables. Furthermore, they implement full <a href="Closure_(computer_science)" class="mw-redirect" title="Closure (computer science)">closures</a> by remembering the outer function's local variables even after the outer function has exited.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">let</span><span class="w"> </span><span class="nx">t</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"Top"</span><span class="p">;</span>
<span class="kd">let</span><span class="w"> </span><span class="nx">bar</span><span class="p">,</span><span class="w"> </span><span class="nx">baz</span><span class="p">;</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">foo</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nx">f</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"foo var"</span><span class="p">;</span>
<span class="w"> </span><span class="nx">bar</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">f</span><span class="p">)</span><span class="w"> </span><span class="p">};</span>
<span class="w"> </span><span class="nx">baz</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="p">(</span><span class="nx">x</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">f</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">x</span><span class="p">;</span><span class="w"> </span><span class="p">};</span>
<span class="p">}</span>
<span class="nx">foo</span><span class="p">();</span>
<span class="nx">baz</span><span class="p">(</span><span class="s2">"baz arg"</span><span class="p">);</span>
<span class="nx">bar</span><span class="p">();</span><span class="w"> </span><span class="c1">// "baz arg" (not "foo var") even though foo() has exited.</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">t</span><span class="p">);</span><span class="w"> </span><span class="c1">// Top</span>
</pre></div>
<p>An <i>anonymous function</i> is simply a function without a name and can be written either using function or arrow notation. In these equivalent examples an anonymous function is passed to the <b>map</b> function and is applied to each of the elements of the array.<sup id="cite_ref-20" class="reference"><a href="#cite_note-20"><span class="cite-bracket">[</span>20<span class="cite-bracket">]</span></a></sup>
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="w"> </span><span class="p">[</span><span class="mf">1</span><span class="p">,</span><span class="mf">2</span><span class="p">,</span><span class="mf">3</span><span class="p">].</span><span class="nx">map</span><span class="p">(</span><span class="kd">function</span><span class="p">(</span><span class="nx">x</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">x</span><span class="o">*</span><span class="mf">2</span><span class="p">;);</span><span class="w"> </span><span class="c1">//returns [2,4,6]</span>
<span class="w"> </span><span class="p">[</span><span class="mf">1</span><span class="p">,</span><span class="mf">2</span><span class="p">,</span><span class="mf">3</span><span class="p">].</span><span class="nx">map</span><span class="p">((</span><span class="nx">x</span><span class="p">)</span><span class="w"> </span><span class="p">=></span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">x</span><span class="o">*</span><span class="mf">2</span><span class="p">;});</span><span class="w"> </span><span class="c1">//same result</span>
</pre></div>
<p>A <i>generator function</i> is signified placing an * after the keyword <i>function</i> and contains one or more <i>yield</i> statements. The effect is to return a value and pause execution at the current state. Declaring an generator function returns an iterator. Subsequent calls to <i>iterator.next()</i> resumes execution until the next <i>yield</i>. When the iterator returns without using a yield statement there are no more values and the <b>done</b> property of the iterator is set to <b>true</b>.<sup id="cite_ref-21" class="reference"><a href="#cite_note-21"><span class="cite-bracket">[</span>21<span class="cite-bracket">]</span></a></sup>
</p><p>With the exception of <a href="IOS" title="IOS">iOS</a> devices from Apple, generators are not implemented for browsers on mobile devices. <sup id="cite_ref-22" class="reference"><a href="#cite_note-22"><span class="cite-bracket">[</span>22<span class="cite-bracket">]</span></a></sup>
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="w"> </span><span class="kd">function</span><span class="o">*</span><span class="w"> </span><span class="nx">generator</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">yield</span><span class="w"> </span><span class="s2">"red"</span><span class="p">;</span>
<span class="w"> </span><span class="k">yield</span><span class="w"> </span><span class="s2">"green"</span><span class="p">;</span>
<span class="w"> </span><span class="k">yield</span><span class="w"> </span><span class="s2">"blue"</span><span class="p">;</span>
<span class="w"> </span><span class="p">}</span><span class="w"> </span>
<span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nx">iterator</span><span class="o">=</span><span class="nx">generator</span><span class="p">();</span><span class="w"> </span>
<span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nx">current</span><span class="p">;</span>
<span class="w"> </span><span class="k">while</span><span class="p">(</span><span class="nx">current</span><span class="o">=</span><span class="nx">iterator</span><span class="p">.</span><span class="nx">next</span><span class="p">().</span><span class="nx">value</span><span class="p">)</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">current</span><span class="p">);</span><span class="w"> </span><span class="c1">//displays red, green then blue</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">iterator</span><span class="p">.</span><span class="nx">next</span><span class="p">().</span><span class="nx">done</span><span class="p">)</span><span class="w"> </span><span class="c1">//displays true</span>
</pre></div>
<p><br>
</p>
<div class="mw-heading mw-heading3"><h3 id="Async/await">Async/await</h3></div>
<div class="excerpt-block"><div role="note" class="hatnote navigation-not-searchable dablink excerpt-hat selfref">This section is an excerpt from <a href="Async/await#In_JavaScript" title="Async/await">Async/await § In JavaScript</a>.<span class="mw-editsection-like "><span class="mw-editsection-bracket">[</span><a class="external text external" href="https://en.wikipedia.org/w/index.php?title=Async/await&action=edit">edit</a><span class="mw-editsection-bracket">]</span></span></div><div class="excerpt">
<p>The await operator in JavaScript can only be used from inside an async function or at the top level of a <a href="Modular_programming" title="Modular programming">module</a>. If the parameter is a <a href="Futures_and_promises" title="Futures and promises">promise</a>, execution of the async function will resume when the promise is resolved (unless the promise is rejected, in which case an error will be thrown that can be handled with normal JavaScript <a href="Exception_handling" title="Exception handling">exception handling</a>). If the parameter is not a promise, the parameter itself will be returned immediately.<sup id="cite_ref-23" class="reference"><a href="#cite_note-23"><span class="cite-bracket">[</span>23<span class="cite-bracket">]</span></a></sup>
</p><p>Many libraries provide promise objects that can also be used with await, as long as they match the specification for native JavaScript promises. However, promises from the <a href="JQuery" title="JQuery">jQuery</a> library were not Promises/A+ compatible until jQuery 3.0.<sup id="cite_ref-24" class="reference"><a href="#cite_note-24"><span class="cite-bracket">[</span>24<span class="cite-bracket">]</span></a></sup>
</p><p>Below is an example (modified from this<sup id="cite_ref-Async/await_JavaScript-async-await_25-0" class="reference"><a href="#cite_note-Async/await_JavaScript-async-await-25"><span class="cite-bracket">[</span>25<span class="cite-bracket">]</span></a></sup> article):
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">async</span><span class="w"> </span><span class="kd">function</span><span class="w"> </span><span class="nx">createNewDoc</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nx">response</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">await</span><span class="w"> </span><span class="nx">db</span><span class="p">.</span><span class="nx">post</span><span class="p">({});</span><span class="w"> </span><span class="c1">// post a new doc</span>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="nx">db</span><span class="p">.</span><span class="nx">get</span><span class="p">(</span><span class="nx">response</span><span class="p">.</span><span class="nx">id</span><span class="p">);</span><span class="w"> </span><span class="c1">// find by id</span>
<span class="p">}</span>
<span class="k">async</span><span class="w"> </span><span class="kd">function</span><span class="w"> </span><span class="nx">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">try</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="kd">let</span><span class="w"> </span><span class="nx">doc</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">await</span><span class="w"> </span><span class="nx">createNewDoc</span><span class="p">();</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">doc</span><span class="p">);</span>
<span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="nx">err</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">err</span><span class="p">);</span>
<span class="w"> </span><span class="p">}</span>
<span class="p">}</span>
<span class="nx">main</span><span class="p">();</span>
</pre></div>
<a href="Node.js" title="Node.js">Node.js</a> version 8 includes a utility that enables using the standard library callback-based methods as promises.<sup id="cite_ref-26" class="reference"><a href="#cite_note-26"><span class="cite-bracket">[</span>26<span class="cite-bracket">]</span></a></sup></div></div>
<div class="mw-heading mw-heading2"><h2 id="Objects">Objects</h2></div>
<p>For convenience, types are normally subdivided into <i>primitives</i> and <i>objects</i>. Objects are entities that have an identity (they are only equal to themselves) and that map property names to values ("slots" in <a href="Prototype-based_programming" title="Prototype-based programming">prototype-based programming</a> terminology). Objects may be thought of as <a href="Associative_arrays" class="mw-redirect" title="Associative arrays">associative arrays</a> or hashes, and are often implemented using these data structures. However, objects have additional features, such as a <a href="Prototype-based_programming" title="Prototype-based programming">prototype chain</a>, which ordinary associative arrays do not have.
</p><p>JavaScript has several kinds of built-in objects, namely <code>Array</code>, <code>Boolean</code>, <code>Date</code>, <code>Function</code>, <code>Math</code>, <code>Number</code>, <code>Object</code>, <code>RegExp</code> and <code>String</code>. Other objects are "host objects", defined not by the language, but by the runtime environment. For example, in a browser, typical host objects belong to the DOM (window, form, links, etc.).
</p>
<div class="mw-heading mw-heading3"><h3 id="Creating_objects">Creating objects</h3></div>
<p>Objects can be created using a constructor or an object literal. The constructor can use either a built-in Object function or a custom function. It is a convention that constructor functions are given a name that starts with a capital letter:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="c1">// Constructor</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">anObject</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">Object</span><span class="p">();</span>
<span class="c1">// Object literal</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">objectA</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{};</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">objectA2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{};</span><span class="w"> </span><span class="c1">// A != A2, {}s create new objects as copies.</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">objectB</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="nx">index1</span><span class="o">:</span><span class="w"> </span><span class="s1">'value 1'</span><span class="p">,</span><span class="w"> </span><span class="nx">index2</span><span class="o">:</span><span class="w"> </span><span class="s1">'value 2'</span><span class="p">};</span>
<span class="c1">// Custom constructor (see below)</span>
</pre></div>
<p>Object literals and array literals allow one to easily create flexible data structures:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">const</span><span class="w"> </span><span class="nx">myStructure</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">name</span><span class="o">:</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="nx">first</span><span class="o">:</span><span class="w"> </span><span class="s2">"Mel"</span><span class="p">,</span>
<span class="w"> </span><span class="nx">last</span><span class="o">:</span><span class="w"> </span><span class="s2">"Smith"</span>
<span class="w"> </span><span class="p">},</span>
<span class="w"> </span><span class="nx">age</span><span class="o">:</span><span class="w"> </span><span class="mf">33</span><span class="p">,</span>
<span class="w"> </span><span class="nx">hobbies</span><span class="o">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"chess"</span><span class="p">,</span><span class="w"> </span><span class="s2">"jogging"</span><span class="p">]</span>
<span class="p">};</span>
</pre></div>
<p>This is the basis for <a href="JSON" title="JSON">JSON</a>, which is a simple notation that uses JavaScript-like syntax for data exchange.
</p>
<div class="mw-heading mw-heading3"><h3 id="Methods">Methods</h3></div>
<p>A <a href="Method_(computer_programming)" title="Method (computer programming)">method</a> is simply a function that has been assigned to a property name of an object. Unlike many object-oriented languages, there is no distinction between a function definition and a method definition in object-related JavaScript. Rather, the distinction occurs during function calling; a function can be called as a method.
</p><p>When called as a method, the standard local variable <i><span class="monospaced">this</span></i> is just automatically set to the object instance to the left of the "<span class="monospaced">.</span>". (There are also <i><span class="monospaced">call</span></i> and <i><span class="monospaced">apply</span></i> methods that can set <i><span class="monospaced">this</span></i> explicitly—some packages such as <a href="JQuery" title="JQuery">jQuery</a> do unusual things with <i><span class="monospaced">this</span></i>.)
</p><p>In the example below, Foo is being used as a constructor. There is nothing special about a constructor - it is just a plain function that initializes an object. When used with the <i><span class="monospaced">new</span></i> keyword, as is the norm, <i><span class="monospaced">this</span></i> is set to a newly created blank object.
</p><p>Note that in the example below, Foo is simply assigning values to slots, some of which are functions. Thus it can assign different functions to different instances. There is no prototyping in this example.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">function</span><span class="w"> </span><span class="nx">px</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">prefix</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s2">"X"</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">Foo</span><span class="p">(</span><span class="nx">yz</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">prefix</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"a-"</span><span class="p">;</span>
<span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="nx">yz</span><span class="w"> </span><span class="o">></span><span class="w"> </span><span class="mf">0</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">pyz</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">prefix</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s2">"Y"</span><span class="p">;</span><span class="w"> </span><span class="p">};</span>
<span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="k">else</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">pyz</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">prefix</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="s2">"Z"</span><span class="p">;</span><span class="w"> </span><span class="p">};</span>
<span class="w"> </span><span class="p">}</span>
<span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">m1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">px</span><span class="p">;</span>
<span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="k">this</span><span class="p">;</span>
<span class="p">}</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">foo1</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nx">Foo</span><span class="p">(</span><span class="mf">1</span><span class="p">);</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">foo2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nx">Foo</span><span class="p">(</span><span class="mf">0</span><span class="p">);</span>
<span class="nx">foo2</span><span class="p">.</span><span class="nx">prefix</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"b-"</span><span class="p">;</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"foo1/2 "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">foo1</span><span class="p">.</span><span class="nx">pyz</span><span class="p">()</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">foo2</span><span class="p">.</span><span class="nx">pyz</span><span class="p">());</span>
<span class="c1">// foo1/2 a-Y b-Z</span>
<span class="nx">foo1</span><span class="p">.</span><span class="nx">m3</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">px</span><span class="p">;</span><span class="w"> </span><span class="c1">// Assigns the function itself, not its evaluated result, i.e. not px()</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">baz</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="s2">"prefix"</span><span class="o">:</span><span class="w"> </span><span class="s2">"c-"</span><span class="p">};</span>
<span class="nx">baz</span><span class="p">.</span><span class="nx">m4</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">px</span><span class="p">;</span><span class="w"> </span><span class="c1">// No need for a constructor to make an object.</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"m1/m3/m4 "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">foo1</span><span class="p">.</span><span class="nx">m1</span><span class="p">()</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">foo1</span><span class="p">.</span><span class="nx">m3</span><span class="p">()</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">baz</span><span class="p">.</span><span class="nx">m4</span><span class="p">());</span>
<span class="c1">// m1/m3/m4 a-X a-X c-X</span>
<span class="nx">foo1</span><span class="p">.</span><span class="nx">m2</span><span class="p">();</span><span class="w"> </span><span class="c1">// Throws an exception, because foo1.m2 does not exist.</span>
</pre></div>
<div class="mw-heading mw-heading3"><h3 id="Constructors">Constructors</h3></div>
<p><a href="Constructor_function" class="mw-redirect" title="Constructor function">Constructor functions</a> simply assign values to slots of a newly created object. The values may be data or other functions.
</p><p>Example: Manipulating an object:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">function</span><span class="w"> </span><span class="nx">MyObject</span><span class="p">(</span><span class="nx">attributeA</span><span class="p">,</span><span class="w"> </span><span class="nx">attributeB</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">attributeA</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">attributeA</span><span class="p">;</span>
<span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">attributeB</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">attributeB</span><span class="p">;</span>
<span class="p">}</span>
<span class="nx">MyObject</span><span class="p">.</span><span class="nx">staticC</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">"blue"</span><span class="p">;</span><span class="w"> </span><span class="c1">// On MyObject Function, not object</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">MyObject</span><span class="p">.</span><span class="nx">staticC</span><span class="p">);</span><span class="w"> </span><span class="c1">// blue</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">object</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nx">MyObject</span><span class="p">(</span><span class="s1">'red'</span><span class="p">,</span><span class="w"> </span><span class="mf">1000</span><span class="p">);</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">object</span><span class="p">.</span><span class="nx">attributeA</span><span class="p">);</span><span class="w"> </span><span class="c1">// red</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">object</span><span class="p">.</span><span class="nx">attributeB</span><span class="p">);</span><span class="w"> </span><span class="c1">// 1000</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">object</span><span class="p">.</span><span class="nx">staticC</span><span class="p">);</span><span class="w"> </span><span class="c1">// undefined</span>
<span class="nx">object</span><span class="p">.</span><span class="nx">attributeC</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nb">Date</span><span class="p">();</span><span class="w"> </span><span class="c1">// add a new property</span>
<span class="ow">delete</span><span class="w"> </span><span class="nx">object</span><span class="p">.</span><span class="nx">attributeB</span><span class="p">;</span><span class="w"> </span><span class="c1">// remove a property of object</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">object</span><span class="p">.</span><span class="nx">attributeB</span><span class="p">);</span><span class="w"> </span><span class="c1">// undefined</span>
</pre></div>
<p>The constructor itself is referenced in the object's prototype's <i>constructor</i> slot. So,
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">function</span><span class="w"> </span><span class="nx">Foo</span><span class="p">()</span><span class="w"> </span><span class="p">{}</span>
<span class="c1">// Use of 'new' sets prototype slots (for example, </span>
<span class="c1">// x = new Foo() would set x's prototype to Foo.prototype,</span>
<span class="c1">// and Foo.prototype has a constructor slot pointing back to Foo).</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nx">Foo</span><span class="p">();</span>
<span class="c1">// The above is almost equivalent to</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">y</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{};</span>
<span class="nx">y</span><span class="p">.</span><span class="kr">constructor</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">Foo</span><span class="p">;</span>
<span class="nx">y</span><span class="p">.</span><span class="kr">constructor</span><span class="p">();</span>
<span class="c1">// Except</span>
<span class="nx">x</span><span class="p">.</span><span class="kr">constructor</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="nx">y</span><span class="p">.</span><span class="kr">constructor</span><span class="p">;</span><span class="w"> </span><span class="c1">// true</span>
<span class="nx">x</span><span class="w"> </span><span class="ow">instanceof</span><span class="w"> </span><span class="nx">Foo</span><span class="p">;</span><span class="w"> </span><span class="c1">// true</span>
<span class="nx">y</span><span class="w"> </span><span class="ow">instanceof</span><span class="w"> </span><span class="nx">Foo</span><span class="p">;</span><span class="w"> </span><span class="c1">// false</span>
<span class="c1">// y's prototype is Object.prototype, not</span>
<span class="c1">// Foo.prototype, since it was initialized with</span>
<span class="c1">// {} instead of new Foo.</span>
<span class="c1">// Even though Foo is set to y's constructor slot,</span>
<span class="c1">// this is ignored by instanceof - only y's prototype's</span>
<span class="c1">// constructor slot is considered.</span>
</pre></div>
<p>Functions are objects themselves, which can be used to produce an effect similar to "static properties" (using C++/Java terminology) as shown below. (The function object also has a special <code>prototype</code> property, as discussed in the "Inheritance" section below.)
</p><p>Object deletion is rarely used as the scripting engine will <a href="Garbage_collection_(computer_science)" title="Garbage collection (computer science)">garbage collect</a> objects that are no longer being referenced.
</p>
<div class="mw-heading mw-heading3"><h3 id="Inheritance">Inheritance</h3></div>
<p>JavaScript supports inheritance hierarchies through prototyping in the manner of <a href="Self_(programming_language)" title="Self (programming language)">Self</a>.
</p><p>In the following example, the <span class="monospaced">Derived</span> class inherits from the <span class="monospaced">Base</span> class.
When <span class="monospaced">d</span> is created as <span class="monospaced">Derived</span>, the reference to the base instance of <span class="monospaced">Base</span> is copied to <span class="monospaced">d.base</span>.
</p><p>Derive does not contain a value for <span class="monospaced">aBaseFunction</span>, so it is retrieved from <span class="monospaced">aBaseFunction</span> <i>when <span class="monospaced">aBaseFunction</span> is accessed</i>. This is made clear by changing the value of <span class="monospaced">base.aBaseFunction</span>, which is reflected in the value of <span class="monospaced">d.aBaseFunction</span>.
</p><p>Some implementations allow the prototype to be accessed or set explicitly using the <span class="monospaced">__proto__</span> slot as shown below.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">function</span><span class="w"> </span><span class="nx">Base</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">anOverride</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"Base::anOverride()"</span><span class="p">);</span><span class="w"> </span><span class="p">};</span>
<span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">aBaseFunction</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"Base::aBaseFunction()"</span><span class="p">);</span><span class="w"> </span><span class="p">};</span>
<span class="p">}</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">Derived</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">anOverride</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"Derived::anOverride()"</span><span class="p">);</span><span class="w"> </span><span class="p">};</span>
<span class="p">}</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">base</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nx">Base</span><span class="p">();</span>
<span class="nx">Derived</span><span class="p">.</span><span class="nx">prototype</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">base</span><span class="p">;</span><span class="w"> </span><span class="c1">// Must be before new Derived()</span>
<span class="nx">Derived</span><span class="p">.</span><span class="nx">prototype</span><span class="p">.</span><span class="kr">constructor</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">Derived</span><span class="p">;</span><span class="w"> </span><span class="c1">// Required to make `instanceof` work</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">d</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nx">Derived</span><span class="p">();</span><span class="w"> </span><span class="c1">// Copies Derived.prototype to d instance's hidden prototype slot.</span>
<span class="nx">d</span><span class="w"> </span><span class="ow">instanceof</span><span class="w"> </span><span class="nx">Derived</span><span class="p">;</span><span class="w"> </span><span class="c1">// true</span>
<span class="nx">d</span><span class="w"> </span><span class="ow">instanceof</span><span class="w"> </span><span class="nx">Base</span><span class="p">;</span><span class="w"> </span><span class="c1">// true</span>
<span class="nx">base</span><span class="p">.</span><span class="nx">aBaseFunction</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"Base::aNEWBaseFunction()"</span><span class="p">);</span><span class="w"> </span><span class="p">};</span>
<span class="nx">d</span><span class="p">.</span><span class="nx">anOverride</span><span class="p">();</span><span class="w"> </span><span class="c1">// Derived::anOverride()</span>
<span class="nx">d</span><span class="p">.</span><span class="nx">aBaseFunction</span><span class="p">();</span><span class="w"> </span><span class="c1">// Base::aNEWBaseFunction()</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">d</span><span class="p">.</span><span class="nx">aBaseFunction</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="nx">Derived</span><span class="p">.</span><span class="nx">prototype</span><span class="p">.</span><span class="nx">aBaseFunction</span><span class="p">);</span><span class="w"> </span><span class="c1">// true</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="nx">d</span><span class="p">.</span><span class="nx">__proto__</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="nx">base</span><span class="p">);</span><span class="w"> </span><span class="c1">// true in Mozilla-based implementations and false in many others.</span>
</pre></div>
<p>The following shows clearly how references to prototypes are <i>copied</i> on instance creation, but that changes to a prototype can affect all instances that refer to it.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="kd">function</span><span class="w"> </span><span class="nx">m1</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="s2">"One"</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">m2</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="s2">"Two"</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">m3</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="s2">"Three"</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">Base</span><span class="p">()</span><span class="w"> </span><span class="p">{}</span>
<span class="nx">Base</span><span class="p">.</span><span class="nx">prototype</span><span class="p">.</span><span class="nx">m</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">m2</span><span class="p">;</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">bar</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nx">Base</span><span class="p">();</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"bar.m "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">bar</span><span class="p">.</span><span class="nx">m</span><span class="p">());</span><span class="w"> </span><span class="c1">// bar.m Two</span>
<span class="kd">function</span><span class="w"> </span><span class="nx">Top</span><span class="p">()</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">m</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">m3</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">t</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nx">Top</span><span class="p">();</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">foo</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nx">Base</span><span class="p">();</span>
<span class="nx">Base</span><span class="p">.</span><span class="nx">prototype</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">t</span><span class="p">;</span>
<span class="c1">// No effect on foo, the *reference* to t is copied.</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"foo.m "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">foo</span><span class="p">.</span><span class="nx">m</span><span class="p">());</span><span class="w"> </span><span class="c1">// foo.m Two</span>
<span class="kd">const</span><span class="w"> </span><span class="nx">baz</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="ow">new</span><span class="w"> </span><span class="nx">Base</span><span class="p">();</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"baz.m "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">baz</span><span class="p">.</span><span class="nx">m</span><span class="p">());</span><span class="w"> </span><span class="c1">// baz.m Three</span>
<span class="nx">t</span><span class="p">.</span><span class="nx">m</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">m1</span><span class="p">;</span><span class="w"> </span><span class="c1">// Does affect baz, and any other derived classes.</span>
<span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"baz.m1 "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nx">baz</span><span class="p">.</span><span class="nx">m</span><span class="p">());</span><span class="w"> </span><span class="c1">// baz.m1 One</span>
</pre></div>
<p>In practice many variations of these themes are used, and it can be both powerful and confusing.
</p>
<div class="mw-heading mw-heading2"><h2 id="Exception_handling">Exception handling</h2></div>
<p>JavaScript includes a <code>try ... catch ... finally</code> <a href="Exception_handling" title="Exception handling">exception handling</a> statement to handle run-time errors.
</p><p>The <code>try ... catch ... finally</code> statement catches <a href="Exception_handling" title="Exception handling">exceptions</a> resulting from an error or a throw statement. Its syntax is as follows:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">try</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="c1">// Statements in which exceptions might be thrown</span>
<span class="p">}</span><span class="w"> </span><span class="k">catch</span><span class="p">(</span><span class="nx">errorValue</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="c1">// Statements that execute in the event of an exception</span>
<span class="p">}</span><span class="w"> </span><span class="k">finally</span><span class="w"> </span><span class="p">{</span>
<span class="w"> </span><span class="c1">// Statements that execute afterward either way</span>
<span class="p">}</span>
</pre></div>
<p>Initially, the statements within the try block execute. If an exception is thrown, the script's control flow immediately transfers to the statements in the catch block, with the exception available as the error argument. Otherwise the catch block is skipped. The catch block can <span class="monospaced">throw(errorValue)</span>, if it does not want to handle a specific error.
</p><p>In any case the statements in the finally block are always executed. This can be used to free resources, although memory is automatically garbage collected.
</p><p>Either the catch or the finally clause may be omitted. The catch argument is required.
</p><p>The Mozilla implementation allows for multiple catch statements, as an extension to the ECMAScript standard. They follow a syntax similar to that used in <a href="Java_(programming_language)" title="Java (programming language)">Java</a>:
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="k">try</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">statement</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
<span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="nx">e</span><span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="nx">e</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="s2">"InvalidNameException"</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">statement</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
<span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="nx">e</span><span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="nx">e</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="s2">"InvalidIdException"</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">statement</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
<span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="nx">e</span><span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="nx">e</span><span class="w"> </span><span class="o">==</span><span class="w"> </span><span class="s2">"InvalidEmailException"</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">statement</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
<span class="k">catch</span><span class="w"> </span><span class="p">(</span><span class="nx">e</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">statement</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
</pre></div>
<p>In a browser, the <span class="monospaced">onerror</span> event is more commonly used to trap exceptions.
</p>
<div class="mw-highlight mw-highlight-lang-javascript mw-content-ltr" dir="ltr"><pre><span class="nx">onerror</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kd">function</span><span class="w"> </span><span class="p">(</span><span class="nx">errorValue</span><span class="p">,</span><span class="w"> </span><span class="nx">url</span><span class="p">,</span><span class="w"> </span><span class="nx">lineNr</span><span class="p">)</span><span class="w"> </span><span class="p">{...;</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="kc">true</span><span class="p">;};</span>
</pre></div>
<div class="mw-heading mw-heading2"><h2 id="Native_functions_and_methods">Native functions and methods</h2></div>
<div class="mw-heading mw-heading3"><h3 id="eval_(expression)">eval (expression)</h3></div>
<p>Evaluates the first parameter as an expression, which can include assignment statements. Variables local to functions can be referenced by the expression. However, <code class="mw-highlight mw-highlight-lang-text mw-content-ltr" style="" dir="ltr">eval</code> represents a major security risk, as it allows a bad actor to execute arbitrary code, so its use is discouraged.<sup id="cite_ref-deve_eval_27-0" class="reference"><a href="#cite_note-deve_eval-27"><span class="cite-bracket">[</span>27<span class="cite-bracket">]</span></a></sup>
</p>
<div class="mw-highlight mw-highlight-lang-nodejsrepl mw-content-ltr" dir="ltr"><pre><span class="gp">></span><span class="w"> </span><span class="p">(</span><span class="kd">function</span><span class="w"> </span><span class="nx">foo</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
<span class="gp">...</span><span class="w"> </span><span class="kd">var</span><span class="w"> </span><span class="nx">x</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">7</span><span class="p">;</span>
<span class="gp">...</span><span class="w"> </span><span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span><span class="s2">"val "</span><span class="w"> </span><span class="o">+</span><span class="w"> </span><span class="nb">eval</span><span class="p">(</span><span class="s2">"x + 2"</span><span class="p">));</span>
<span class="gp">...</span><span class="w"> </span><span class="p">})();</span>
<span class="nx">val</span><span class="w"> </span><span class="mf">9</span>
<span class="kc">undefined</span>
</pre></div>
<div class="mw-heading mw-heading2"><h2 id="See_also">See also</h2></div>
<ul><li><a href="Comparison_of_JavaScript-based_source_code_editors" title="Comparison of JavaScript-based source code editors">Comparison of JavaScript-based source code editors</a></li>
<li><a href="JavaScript" title="JavaScript">JavaScript</a></li></ul>
<div class="mw-heading mw-heading2"><h2 id="References">References</h2></div>
<style data-mw-deduplicate="TemplateStyles:r1239543626">
/* start https://en.wikipedia.org/ */
.mw-parser-output .reflist{margin-bottom:0.5em;list-style-type:decimal}@media screen{.mw-parser-output .reflist{font-size:90%}}.mw-parser-output .reflist .references{font-size:100%;margin-bottom:0;list-style-type:inherit}.mw-parser-output .reflist-columns-2{column-width:30em}.mw-parser-output .reflist-columns-3{column-width:25em}.mw-parser-output .reflist-columns{margin-top:0.3em}.mw-parser-output .reflist-columns ol{margin-top:0}.mw-parser-output .reflist-columns li{page-break-inside:avoid;break-inside:avoid-column}.mw-parser-output .reflist-upper-alpha{list-style-type:upper-alpha}.mw-parser-output .reflist-upper-roman{list-style-type:upper-roman}.mw-parser-output .reflist-lower-alpha{list-style-type:lower-alpha}.mw-parser-output .reflist-lower-greek{list-style-type:lower-greek}.mw-parser-output .reflist-lower-roman{list-style-type:lower-roman}
/* end https://en.wikipedia.org/ */
</style><div class="reflist">
<div class="mw-references-wrap mw-references-columns"><ol class="references">
<li id="cite_note-1"><span class="mw-cite-backlink"><b><a href="#cite_ref-1">^</a></b></span> <span class="reference-text"><style data-mw-deduplicate="TemplateStyles:r1238218222">
/* start https://en.wikipedia.org/ */
.mw-parser-output cite.citation{font-style:inherit;word-wrap:break-word}.mw-parser-output .citation q{quotes:"\"""\"""'""'"}.mw-parser-output .citation:target{background-color:rgba(0,127,255,0.133)}.mw-parser-output .id-lock-free.id-lock-free a{background:url("./mw/Lock-green.svg")right 0.1em center/9px no-repeat}.mw-parser-output .id-lock-limited.id-lock-limited a,.mw-parser-output .id-lock-registration.id-lock-registration a{background:url("./mw/Lock-gray-alt-2.svg")right 0.1em center/9px no-repeat}.mw-parser-output .id-lock-subscription.id-lock-subscription a{background:url("./mw/Lock-red-alt-2.svg")right 0.1em center/9px no-repeat}.mw-parser-output .cs1-ws-icon a{background:url("./mw/Wikisource-logo.svg")right 0.1em center/12px no-repeat}body:not(.skin-timeless):not(.skin-minerva) .mw-parser-output .id-lock-free a,body:not(.skin-timeless):not(.skin-minerva) .mw-parser-output .id-lock-limited a,body:not(.skin-timeless):not(.skin-minerva) .mw-parser-output .id-lock-registration a,body:not(.skin-timeless):not(.skin-minerva) .mw-parser-output .id-lock-subscription a,body:not(.skin-timeless):not(.skin-minerva) .mw-parser-output .cs1-ws-icon a{background-size:contain;padding:0 1em 0 0}.mw-parser-output .cs1-code{color:inherit;background:inherit;border:none;padding:inherit}.mw-parser-output .cs1-hidden-error{display:none;color:var(--color-error,#d33)}.mw-parser-output .cs1-visible-error{color:var(--color-error,#d33)}.mw-parser-output .cs1-maint{display:none;color:#085;margin-left:0.3em}.mw-parser-output .cs1-kern-left{padding-left:0.2em}.mw-parser-output .cs1-kern-right{padding-right:0.2em}.mw-parser-output .citation .mw-selflink{font-weight:inherit}@media screen{.mw-parser-output .cs1-format{font-size:95%}html.skin-theme-clientpref-night .mw-parser-output .cs1-maint{color:#18911f}}@media screen and (prefers-color-scheme:dark){html.skin-theme-clientpref-os .mw-parser-output .cs1-maint{color:#18911f}}
/* end https://en.wikipedia.org/ */
</style><cite class="citation web cs1"><a rel="nofollow" class="external text" href="http://hepunx.rl.ac.uk/~adye/jsspec11/intro.htm#1006028">"JavaScript 1.1 specification"</a>. <a rel="nofollow" class="external text" href="https://web.archive.org/web/20170226200426/http://hepunx.rl.ac.uk/~adye/jsspec11/intro.htm#1006028">Archived</a> from the original on 26 February 2017<span class="reference-accessdate">. Retrieved <span class="nowrap">19 April</span> 2006</span>.</cite></span>
</li>
<li id="cite_note-2"><span class="mw-cite-backlink"><b><a href="#cite_ref-2">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://web.archive.org/web/20220210041253/http://speakingjs.com/es5/ch01.html">"Chapter 1. Basic JavaScript"</a>. <i>speakingjs.com</i>. Archived from <a rel="nofollow" class="external text" href="http://speakingjs.com/es5/ch01.html">the original</a> on 10 February 2022<span class="reference-accessdate">. Retrieved <span class="nowrap">22 September</span> 2020</span>.</cite></span>
</li>
<li id="cite_note-3"><span class="mw-cite-backlink"><b><a href="#cite_ref-3">^</a></b></span> <span class="reference-text"><cite id="CITEREFFlanagan2006" class="citation book cs1">Flanagan, David (2006). <span class="id-lock-registration" title="Free registration required"><a rel="nofollow" class="external text" href="https://archive.org/details/javascript00libg_297"><i>JavaScript: The definitive Guide</i></a></span>. "O'Reilly Media, Inc.". p. <a rel="nofollow" class="external text" href="https://archive.org/details/javascript00libg_297/page/n14">16</a>. <a href="ISBN_(identifier)" class="mw-redirect" title="ISBN (identifier)">ISBN</a> <bdi>978-0-596-10199-2</bdi>. <q>Omitting semicolons is not a good programming practice; you should get into the habit of inserting them.</q></cite></span>
</li>
<li id="cite_note-4"><span class="mw-cite-backlink"><b><a href="#cite_ref-4">^</a></b></span> <span class="reference-text"><cite id="CITEREFFarias" class="citation web cs1">Farias, Bradley. <a rel="nofollow" class="external text" href="https://github.com/tc39/proposal-hashbang">"Hashbang Grammar"</a>. <i>GitHub</i><span class="reference-accessdate">. Retrieved <span class="nowrap">13 July</span> 2025</span>.</cite></span>
</li>
<li id="cite_note-5"><span class="mw-cite-backlink"><b><a href="#cite_ref-5">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en-US/docs/Learn/JavaScript/First_steps/Variables">"Storing the information you need — Variables - Learn web development | MDN"</a>. <i>developer.mozilla.org</i>. 9 May 2023<span class="reference-accessdate">. Retrieved <span class="nowrap">23 June</span> 2023</span>.</cite></span>
</li>
<li id="cite_note-6"><span class="mw-cite-backlink"><b><a href="#cite_ref-6">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://web.archive.org/web/20110629131728/https://developer.mozilla.org/en/JavaScript/Guide/Values%2C_Variables%2C_and_Literals%26revision%3D22#Variables">"Values, Variables, and Literals - MDC"</a>. Mozilla Developer Network. 16 September 2010. Archived from <a rel="nofollow" class="external text" href="https://developer.mozilla.org/en/JavaScript/Guide/Values,_Variables,_and_Literals&revision=22#Variables">the original</a> on 29 June 2011<span class="reference-accessdate">. Retrieved <span class="nowrap">1 February</span> 2020</span>.</cite></span>
</li>
<li id="cite_note-7"><span class="mw-cite-backlink"><b><a href="#cite_ref-7">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://www.w3schools.com/js/js_hoisting.asp">"JavaScript Hoisting"</a>. <a href="W3Schools" title="W3Schools">W3Schools</a>. <a rel="nofollow" class="external text" href="https://web.archive.org/web/20220331225545/https://www.w3schools.com/js/js_hoisting.asp">Archived</a> from the original on 31 March 2022<span class="reference-accessdate">. Retrieved <span class="nowrap">17 December</span> 2021</span>. <q>In JavaScript, a variable can be declared after it has been used. In other words; a variable can be used before it has been declared.</q></cite></span>
</li>
<li id="cite_note-8"><span class="mw-cite-backlink"><b><a href="#cite_ref-8">^</a></b></span> <span class="reference-text">"<a rel="nofollow" class="external text" href="http://www.adequatelygood.com/JavaScript-Scoping-and-Hoisting.html">JavaScript Scoping and Hoisting</a> <a rel="nofollow" class="external text" href="https://web.archive.org/web/20210508121632/http://www.adequatelygood.com/JavaScript-Scoping-and-Hoisting.html">Archived</a> 8 May 2021 at the <a href="Wayback_Machine" title="Wayback Machine">Wayback Machine</a>", <a rel="nofollow" class="external text" href="http://www.adequatelygood.com/about.html">Ben Cherry</a> <a rel="nofollow" class="external text" href="https://web.archive.org/web/20210228091155/http://www.adequatelygood.com/about.html">Archived</a> 28 February 2021 at the <a href="Wayback_Machine" title="Wayback Machine">Wayback Machine</a>, <i><a rel="nofollow" class="external text" href="http://www.adequatelygood.com/">Adequately Good</a> <a rel="nofollow" class="external text" href="https://web.archive.org/web/20220308081510/http://www.adequatelygood.com/">Archived</a> 8 March 2022 at the <a href="Wayback_Machine" title="Wayback Machine">Wayback Machine</a>,</i> 8 February 2010</span>
</li>
<li id="cite_note-9"><span class="mw-cite-backlink"><b><a href="#cite_ref-9">^</a></b></span> <span class="reference-text">ECMA-262 5e edition clarified this behavior with the <i>Declarative Environment Record</i> and <i>Object Environment Record</i>. With this formalism, the <i>global object</i> is the <i>Object Environment Record</i> of the global <i>Lexical Environment</i> (the <i>global scope</i>).</span>
</li>
<li id="cite_note-10"><span class="mw-cite-backlink"><b><a href="#cite_ref-10">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number">"Number - JavaScript"</a>. <i>MDN Web Docs</i><span class="reference-accessdate">. Retrieved <span class="nowrap">13 July</span> 2025</span>.</cite></span>
</li>
<li id="cite_note-bigint-mdn-11"><span class="mw-cite-backlink">^ <a href="#cite_ref-bigint-mdn_11-0"><sup><i><b>a</b></i></sup></a> <a href="#cite_ref-bigint-mdn_11-1"><sup><i><b>b</b></i></sup></a></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt">"BigInt - Javascript"</a>. <i>MDN Web Docs</i><span class="reference-accessdate">. Retrieved <span class="nowrap">13 July</span> 2025</span>.</cite></span>
</li>
<li id="cite_note-12"><span class="mw-cite-backlink"><b><a href="#cite_ref-12">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals">"Template literals"</a>. <i>MDN Web Docs</i>. <a rel="nofollow" class="external text" href="https://web.archive.org/web/20220331204510/https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals">Archived</a> from the original on 31 March 2022<span class="reference-accessdate">. Retrieved <span class="nowrap">4 November</span> 2023</span>.</cite></span>
</li>
<li id="cite_note-13"><span class="mw-cite-backlink"><b><a href="#cite_ref-13">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en/JavaScript/Reference/Operators/Comparison_Operators">"Comparison Operators - MDC Doc Center"</a>. Mozilla. 5 August 2010. <a rel="nofollow" class="external text" href="https://web.archive.org/web/20120504005400/https://developer.mozilla.org/en/JavaScript/Reference/Operators/Comparison_Operators">Archived</a> from the original on 4 May 2012<span class="reference-accessdate">. Retrieved <span class="nowrap">5 March</span> 2011</span>.</cite></span>
</li>
<li id="cite_note-14"><span class="mw-cite-backlink"><b><a href="#cite_ref-14">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="http://javascript.crockford.com/style2.html">"The Elements of JavaScript Style"</a>. Douglas Crockford. <a rel="nofollow" class="external text" href="https://web.archive.org/web/20110317074944/http://javascript.crockford.com/style2.html">Archived</a> from the original on 17 March 2011<span class="reference-accessdate">. Retrieved <span class="nowrap">5 March</span> 2011</span>.</cite></span>
</li>
<li id="cite_note-15"><span class="mw-cite-backlink"><b><a href="#cite_ref-15">^</a></b></span> <span class="reference-text"><cite id="CITEREFOrendorff" class="citation web cs1">Orendorff, Jason. <a rel="nofollow" class="external text" href="https://hacks.mozilla.org/2015/06/es6-in-depth-symbols/">"ES6 In Depth: Symbols"</a>. <i>Mozilla Hacks</i><span class="reference-accessdate">. Retrieved <span class="nowrap">13 July</span> 2025</span>.</cite></span>
</li>
<li id="cite_note-16"><span class="mw-cite-backlink"><b><a href="#cite_ref-16">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_syntax">"Spread syntax (...) - JavaScript | MDN"</a>. <i>developer.mozilla.org</i>. 25 September 2023.</cite></span>
</li>
<li id="cite_note-17"><span class="mw-cite-backlink"><b><a href="#cite_ref-17">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters">"rest parameters"</a>. 9 September 2024. <a rel="nofollow" class="external text" href="https://web.archive.org/web/20180530204951/https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters">Archived</a> from the original on 30 May 2018<span class="reference-accessdate">. Retrieved <span class="nowrap">29 September</span> 2016</span>.</cite></span>
</li>
<li id="cite_note-18"><span class="mw-cite-backlink"><b><a href="#cite_ref-18">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="http://www.ecma-international.org/ecma-262/11.0/index.html">"ECMAScript 2020 Language Specification"</a>. <a href="Ecma_International" title="Ecma International">Ecma International</a>. June 2020.</cite></span>
</li>
<li id="cite_note-19"><span class="mw-cite-backlink"><b><a href="#cite_ref-19">^</a></b></span> <span class="reference-text">ECMA-262, Edition 3, 7.5.3 Future Reserved Words</span>
</li>
<li id="cite_note-20"><span class="mw-cite-backlink"><b><a href="#cite_ref-20">^</a></b></span> <span class="reference-text"><cite id="CITEREFYadav2024" class="citation web cs1">Yadav, Amitya (4 October 2024). <a rel="nofollow" class="external text" href="https://aditya003-ay.medium.com/named-function-vs-anonymous-function-impacts-94e2472ed7bb">"Named function vs Anonymous Function Impacts"</a>. <i>medium.com</i><span class="reference-accessdate">. Retrieved <span class="nowrap">19 February</span> 2025</span>.</cite></span>
</li>
<li id="cite_note-21"><span class="mw-cite-backlink"><b><a href="#cite_ref-21">^</a></b></span> <span class="reference-text"> <cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function*">"function*"</a>. <i>mdm web docs</i><span class="reference-accessdate">. Retrieved <span class="nowrap">23 February</span> 2025</span>.</cite></span>
</li>
<li id="cite_note-22"><span class="mw-cite-backlink"><b><a href="#cite_ref-22">^</a></b></span> <span class="reference-text"> <cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://caniuse.com/?search=generator">"ES6 Generators"</a>. <i>medium.com</i><span class="reference-accessdate">. Retrieved <span class="nowrap">23 February</span> 2025</span>.</cite></span>
</li>
<li id="cite_note-23"><span class="mw-cite-backlink"><b><a href="#cite_ref-23">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await">"await - JavaScript (MDN)"</a><span class="reference-accessdate">. Retrieved <span class="nowrap">2 May</span> 2017</span>.</cite></span>
</li>
<li id="cite_note-24"><span class="mw-cite-backlink"><b><a href="#cite_ref-24">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://jquery.com/upgrade-guide/3.0/#breaking-change-and-feature-jquery-deferred-is-now-promises-a-compatible">"jQuery Core 3.0 Upgrade Guide"</a><span class="reference-accessdate">. Retrieved <span class="nowrap">2 May</span> 2017</span>.</cite></span>
</li>
<li id="cite_note-Async/await_JavaScript-async-await-25"><span class="mw-cite-backlink"><b><a href="#cite_ref-Async/await_JavaScript-async-await_25-0">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="http://pouchdb.com/2015/03/05/taming-the-async-beast-with-es7.html">"Taming the asynchronous beast with ES7"</a><span class="reference-accessdate">. Retrieved <span class="nowrap">12 November</span> 2015</span>.</cite></span>
</li>
<li id="cite_note-26"><span class="mw-cite-backlink"><b><a href="#cite_ref-26">^</a></b></span> <span class="reference-text"><cite id="CITEREFFoundation2017" class="citation web cs1">Foundation, Node.js (30 May 2017). <a rel="nofollow" class="external text" href="https://nodejs.org/en/blog/release/v8.0.0/#improved-support-for-promises">"Node v8.0.0 (Current) - Node.js"</a>. <i>Node.js</i>.</cite></span>
</li>
<li id="cite_note-deve_eval-27"><span class="mw-cite-backlink"><b><a href="#cite_ref-deve_eval_27-0">^</a></b></span> <span class="reference-text"><cite class="citation web cs1"><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval#Never_use_eval!">"eval()"</a>. <i>MDN Web Docs</i>. <a rel="nofollow" class="external text" href="https://web.archive.org/web/20220401220204/https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/eval#Never_use_eval!">Archived</a> from the original on 1 April 2022<span class="reference-accessdate">. Retrieved <span class="nowrap">29 January</span> 2020</span>.</cite></span>
</li>
</ol></div></div>
<div class="mw-heading mw-heading2"><h2 id="Further_reading">Further reading</h2></div>
<ul><li>Danny Goodman: <i>JavaScript Bible</i>, Wiley, John & Sons, <a href="ISBN_(identifier)" class="mw-redirect" title="ISBN (identifier)">ISBN</a> <bdi>0-7645-3342-8</bdi>.</li>
<li>David Flanagan, Paula Ferguson: <i>JavaScript: The Definitive Guide</i>, O'Reilly & Associates, <a href="ISBN_(identifier)" class="mw-redirect" title="ISBN (identifier)">ISBN</a> <bdi>0-596-10199-6</bdi>.</li>
<li>Thomas A. Powell, Fritz Schneider: <i>JavaScript: The Complete Reference</i>, McGraw-Hill Companies, <a href="ISBN_(identifier)" class="mw-redirect" title="ISBN (identifier)">ISBN</a> <bdi>0-07-219127-9</bdi>.</li>
<li>Axel Rauschmayer: <i>Speaking JavaScript: An In-Depth Guide for Programmers</i>, 460 pages, O'Reilly Media, 25 February 2014, <a href="ISBN_(identifier)" class="mw-redirect" title="ISBN (identifier)">ISBN</a> <bdi>978-1449365035</bdi>. (<a rel="nofollow" class="external text" href="http://speakingjs.com/">free online edition</a>)</li>
<li>Emily Vander Veer: <i>JavaScript For Dummies, 4th Edition</i>, Wiley, <a href="ISBN_(identifier)" class="mw-redirect" title="ISBN (identifier)">ISBN</a> <bdi>0-7645-7659-3</bdi>.</li></ul>
<div class="mw-heading mw-heading2"><h2 id="External_links">External links</h2></div>
<style data-mw-deduplicate="TemplateStyles:r1290876196">
/* start https://en.wikipedia.org/ */
.mw-parser-output .side-box{margin:4px 0;box-sizing:border-box;border:1px solid #aaa;font-size:88%;line-height:1.25em;background-color:var(--background-color-interactive-subtle,#f8f9fa);display:flow-root}.mw-parser-output .infobox .side-box{font-size:100%}.mw-parser-output .side-box-abovebelow,.mw-parser-output .side-box-text{padding:0.25em 0.9em}.mw-parser-output .side-box-image{padding:2px 0 2px 0.9em;text-align:center}.mw-parser-output .side-box-imageright{padding:2px 0.9em 2px 0;text-align:center}@media(min-width:500px){.mw-parser-output .side-box-flex{display:flex;align-items:center}.mw-parser-output .side-box-text{flex:1;min-width:0}}@media(min-width:720px){.mw-parser-output .side-box{width:238px}.mw-parser-output .side-box-right{clear:right;float:right;margin-left:1em}.mw-parser-output .side-box-left{margin-right:1em}}
/* end https://en.wikipedia.org/ */
</style><style data-mw-deduplicate="TemplateStyles:r1237033735">
/* start https://en.wikipedia.org/ */
@media print{body.ns-0 .mw-parser-output .sistersitebox{display:none!important}}@media screen{html.skin-theme-clientpref-night .mw-parser-output .sistersitebox img[src*="Wiktionary-logo-en-v2.svg"]{background-color:white}}@media screen and (prefers-color-scheme:dark){html.skin-theme-clientpref-os .mw-parser-output .sistersitebox img[src*="Wiktionary-logo-en-v2.svg"]{background-color:white}}
/* end https://en.wikipedia.org/ */
</style><div class="side-box side-box-right sistersitebox"><style data-mw-deduplicate="TemplateStyles:r1126788409">
/* start https://en.wikipedia.org/ */
.mw-parser-output .plainlist ol,.mw-parser-output .plainlist ul{line-height:inherit;list-style:none;margin:0;padding:0}.mw-parser-output .plainlist ol li,.mw-parser-output .plainlist ul li{margin-bottom:0}
/* end https://en.wikipedia.org/ */
</style>
<div class="side-box-flex">
<div class="side-box-image"><span class="noviewer" typeof="mw:File"></span></div>
<div class="side-box-text plainlist">Wikibooks has a book on the topic of: <i><b><a href="https://en.wikibooks.org/wiki/JavaScript" class="extiw external" title="wikibooks:JavaScript">JavaScript</a></b></i></div></div>
</div>
<ul><li><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en/docs/A_re-introduction_to_JavaScript">A re-introduction to JavaScript - Mozilla Developer Center</a></li>
<li><a rel="nofollow" class="external text" href="https://codetopology.com/category/scripts/javascript-tutorials/">JavaScript Loops</a></li>
<li>ECMAScript standard references: <a rel="nofollow" class="external text" href="http://www.ecma-international.org/publications/standards/Ecma-262.htm">ECMA-262</a></li>
<li><a rel="nofollow" class="external text" href="https://web.archive.org/web/20120527095306/http://javalessons.com/cgi-bin/fun/java-tutorials-main.cgi?sub=javascript&code=script">Interactive JavaScript Lessons - example-based</a></li>
<li><a rel="nofollow" class="external text" href="http://javascript.about.com/">JavaScript on About.com: lessons and explanation</a> <a rel="nofollow" class="external text" href="https://web.archive.org/web/20170225135310/http://javascript.about.com/">Archived</a> 25 February 2017 at the <a href="Wayback_Machine" title="Wayback Machine">Wayback Machine</a></li>
<li><a rel="nofollow" class="external text" href="https://web.archive.org/web/20150110202627/http://wisentechnologies.com/it-courses/JavaScript-Training-in-Chennai.aspx">JavaScript Training</a></li>
<li>Mozilla Developer Center Core References for JavaScript versions <a rel="nofollow" class="external text" href="https://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference">1.5</a>, <a rel="nofollow" class="external text" href="https://web.archive.org/web/20070210000908/http://research.nihonsoft.org/javascript/CoreReferenceJS14/index.html">1.4</a>, <a rel="nofollow" class="external text" href="https://web.archive.org/web/20070210000504/http://research.nihonsoft.org/javascript/ClientReferenceJS13/index.html">1.3</a> and <a rel="nofollow" class="external text" href="https://web.archive.org/web/20070210000545/http://research.nihonsoft.org/javascript/jsref/index.htm">1.2</a></li>
<li><a rel="nofollow" class="external text" href="https://developer.mozilla.org/en/docs/JavaScript">Mozilla JavaScript Language Documentation</a></li></ul>
<div class="navbox-styles"><style data-mw-deduplicate="TemplateStyles:r1129693374">
/* start https://en.wikipedia.org/ */
.mw-parser-output .hlist dl,.mw-parser-output .hlist ol,.mw-parser-output .hlist ul{margin:0;padding:0}.mw-parser-output .hlist dd,.mw-parser-output .hlist dt,.mw-parser-output .hlist li{margin:0;display:inline}.mw-parser-output .hlist.inline,.mw-parser-output .hlist.inline dl,.mw-parser-output .hlist.inline ol,.mw-parser-output .hlist.inline ul,.mw-parser-output .hlist dl dl,.mw-parser-output .hlist dl ol,.mw-parser-output .hlist dl ul,.mw-parser-output .hlist ol dl,.mw-parser-output .hlist ol ol,.mw-parser-output .hlist ol ul,.mw-parser-output .hlist ul dl,.mw-parser-output .hlist ul ol,.mw-parser-output .hlist ul ul{display:inline}.mw-parser-output .hlist .mw-empty-li{display:none}.mw-parser-output .hlist dt::after{content:": "}.mw-parser-output .hlist dd::after,.mw-parser-output .hlist li::after{content:" · ";font-weight:bold}.mw-parser-output .hlist dd:last-child::after,.mw-parser-output .hlist dt:last-child::after,.mw-parser-output .hlist li:last-child::after{content:none}.mw-parser-output .hlist dd dd:first-child::before,.mw-parser-output .hlist dd dt:first-child::before,.mw-parser-output .hlist dd li:first-child::before,.mw-parser-output .hlist dt dd:first-child::before,.mw-parser-output .hlist dt dt:first-child::before,.mw-parser-output .hlist dt li:first-child::before,.mw-parser-output .hlist li dd:first-child::before,.mw-parser-output .hlist li dt:first-child::before,.mw-parser-output .hlist li li:first-child::before{content:" (";font-weight:normal}.mw-parser-output .hlist dd dd:last-child::after,.mw-parser-output .hlist dd dt:last-child::after,.mw-parser-output .hlist dd li:last-child::after,.mw-parser-output .hlist dt dd:last-child::after,.mw-parser-output .hlist dt dt:last-child::after,.mw-parser-output .hlist dt li:last-child::after,.mw-parser-output .hlist li dd:last-child::after,.mw-parser-output .hlist li dt:last-child::after,.mw-parser-output .hlist li li:last-child::after{content:")";font-weight:normal}.mw-parser-output .hlist ol{counter-reset:listitem}.mw-parser-output .hlist ol>li{counter-increment:listitem}.mw-parser-output .hlist ol>li::before{content:" "counter(listitem)"\a0 "}.mw-parser-output .hlist dd ol>li:first-child::before,.mw-parser-output .hlist dt ol>li:first-child::before,.mw-parser-output .hlist li ol>li:first-child::before{content:" ("counter(listitem)"\a0 "}
/* end https://en.wikipedia.org/ */
</style><style data-mw-deduplicate="TemplateStyles:r1236075235">
/* start https://en.wikipedia.org/ */
.mw-parser-output .navbox{box-sizing:border-box;border:1px solid #a2a9b1;width:100%;clear:both;font-size:88%;text-align:center;padding:1px;margin:1em auto 0}.mw-parser-output .navbox .navbox{margin-top:0}.mw-parser-output .navbox+.navbox,.mw-parser-output .navbox+.navbox-styles+.navbox{margin-top:-1px}.mw-parser-output .navbox-inner,.mw-parser-output .navbox-subgroup{width:100%}.mw-parser-output .navbox-group,.mw-parser-output .navbox-title,.mw-parser-output .navbox-abovebelow{padding:0.25em 1em;line-height:1.5em;text-align:center}.mw-parser-output .navbox-group{white-space:nowrap;text-align:right}.mw-parser-output .navbox,.mw-parser-output .navbox-subgroup{background-color:#fdfdfd}.mw-parser-output .navbox-list{line-height:1.5em;border-color:#fdfdfd}.mw-parser-output .navbox-list-with-group{text-align:left;border-left-width:2px;border-left-style:solid}.mw-parser-output tr+tr>.navbox-abovebelow,.mw-parser-output tr+tr>.navbox-group,.mw-parser-output tr+tr>.navbox-image,.mw-parser-output tr+tr>.navbox-list{border-top:2px solid #fdfdfd}.mw-parser-output .navbox-title{background-color:#ccf}.mw-parser-output .navbox-abovebelow,.mw-parser-output .navbox-group,.mw-parser-output .navbox-subgroup .navbox-title{background-color:#ddf}.mw-parser-output .navbox-subgroup .navbox-group,.mw-parser-output .navbox-subgroup .navbox-abovebelow{background-color:#e6e6ff}.mw-parser-output .navbox-even{background-color:#f7f7f7}.mw-parser-output .navbox-odd{background-color:transparent}.mw-parser-output .navbox .hlist td dl,.mw-parser-output .navbox .hlist td ol,.mw-parser-output .navbox .hlist td ul,.mw-parser-output .navbox td.hlist dl,.mw-parser-output .navbox td.hlist ol,.mw-parser-output .navbox td.hlist ul{padding:0.125em 0}.mw-parser-output .navbox .navbar{display:block;font-size:100%}.mw-parser-output .navbox-title .navbar{float:left;text-align:left;margin-right:0.5em}body.skin--responsive .mw-parser-output .navbox-image img{max-width:none!important}@media print{body.ns-0 .mw-parser-output .navbox{display:none!important}}
/* end https://en.wikipedia.org/ */
</style></div><div role="navigation" class="navbox" aria-labelledby="JavaScript497" style="padding:3px"><table class="nowraplinks mw-collapsible autocollapse navbox-inner" style="border-spacing:0;background:transparent;color:inherit"><tbody><tr><th scope="col" class="navbox-title" colspan="2"><style data-mw-deduplicate="TemplateStyles:r1239400231">
/* start https://en.wikipedia.org/ */
.mw-parser-output .navbar{display:inline;font-size:88%;font-weight:normal}.mw-parser-output .navbar-collapse{float:left;text-align:left}.mw-parser-output .navbar-boxtext{word-spacing:0}.mw-parser-output .navbar ul{display:inline-block;white-space:nowrap;line-height:inherit}.mw-parser-output .navbar-brackets::before{margin-right:-0.125em;content:"[ "}.mw-parser-output .navbar-brackets::after{margin-left:-0.125em;content:" ]"}.mw-parser-output .navbar li{word-spacing:-0.125em}.mw-parser-output .navbar a>span,.mw-parser-output .navbar a>abbr{text-decoration:inherit}.mw-parser-output .navbar-mini abbr{font-variant:small-caps;border-bottom:none;text-decoration:none;cursor:inherit}.mw-parser-output .navbar-ct-full{font-size:114%;margin:0 7em}.mw-parser-output .navbar-ct-mini{font-size:114%;margin:0 4em}html.skin-theme-clientpref-night .mw-parser-output .navbar li a abbr{color:var(--color-base)!important}@media(prefers-color-scheme:dark){html.skin-theme-clientpref-os .mw-parser-output .navbar li a abbr{color:var(--color-base)!important}}@media print{.mw-parser-output .navbar{display:none!important}}
/* end https://en.wikipedia.org/ */
</style><div id="JavaScript497" style="font-size:114%;margin:0 4em"><a href="JavaScript" title="JavaScript">JavaScript</a></div></th></tr><tr><th scope="row" class="navbox-group" style="width:1%"><a href="Static_program_analysis" title="Static program analysis">Code analysis</a></th><td class="navbox-list-with-group navbox-list navbox-odd hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="ESLint" title="ESLint">ESLint</a></li>
<li><a href="JSHint" title="JSHint">JSHint</a></li>
<li><a href="JSLint" title="JSLint">JSLint</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%"><a href="Subset" title="Subset">Supersets</a></th><td class="navbox-list-with-group navbox-list navbox-even hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="ArkTS" title="ArkTS">ArkTS</a></li>
<li><a href="JS%2B%2B" title="JS++">JS++</a></li>
<li><a href="TypeScript" title="TypeScript">TypeScript</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%"><a href="Source-to-source_compiler" title="Source-to-source compiler">Transpilers</a></th><td class="navbox-list-with-group navbox-list navbox-odd hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="AtScript" title="AtScript">AtScript</a></li>
<li><a href="Babel_(transcompiler)" title="Babel (transcompiler)">Babel</a></li>
<li><a href="ClojureScript" class="mw-redirect" title="ClojureScript">ClojureScript</a></li>
<li><a href="CoffeeScript" title="CoffeeScript">CoffeeScript</a></li>
<li><a href="Dart_(programming_language)" title="Dart (programming language)">Dart</a></li>
<li><a href="Elm_(programming_language)" title="Elm (programming language)">Elm</a></li>
<li><a href="Emscripten" title="Emscripten">Emscripten</a></li>
<li><a href="Google_Closure_Compiler" class="mw-redirect" title="Google Closure Compiler">Google Closure Compiler</a></li>
<li><a href="Google_Web_Toolkit" title="Google Web Toolkit">Google Web Toolkit</a></li>
<li><a href="Haxe" title="Haxe">Haxe</a></li>
<li><a href="LiveScript_(programming_language)" title="LiveScript (programming language)">LiveScript</a></li>
<li><a href="Morfik" title="Morfik">Morfik</a></li>
<li><a href="Nim_(programming_language)" title="Nim (programming language)">Nim</a></li>
<li><a href="Opa_(programming_language)" title="Opa (programming language)">Opa</a></li>
<li><a href="PureScript" title="PureScript">PureScript</a></li>
<li><a href="Reason_(programming_language)" title="Reason (programming language)">Reason</a></li>
<li><a href="WebSharper" title="WebSharper">WebSharper</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%">Concepts</th><td class="navbox-list-with-group navbox-list navbox-even hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="JavaScript_library" title="JavaScript library">JavaScript library</a></li>
<li><a href="JavaScript_stack" title="JavaScript stack">JavaScript stack</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%"><a href="Debugger" title="Debugger">Debuggers</a></th><td class="navbox-list-with-group navbox-list navbox-odd hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="Chrome_(browser)" class="mw-redirect" title="Chrome (browser)">Chrome DevTools</a></li>
<li><a href="Firefox" title="Firefox">Firefox</a> Inspector</li>
<li><a href="Komodo_IDE" title="Komodo IDE">Komodo IDE</a></li>
<li><a href="Safari_(web_browser)" title="Safari (web browser)">Safari</a> Web Inspector</li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%"><a href="Documentation_generator" title="Documentation generator">Documentation generators</a></th><td class="navbox-list-with-group navbox-list navbox-even hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="JSDoc" title="JSDoc">JSDoc</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%">Editors (<a href="Comparison_of_JavaScript-based_source_code_editors" title="Comparison of JavaScript-based source code editors">comparison</a>)</th><td class="navbox-list-with-group navbox-list navbox-odd hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="Ace_(editor)" title="Ace (editor)">Ace</a>
<ul><li><a href="Cloud9_IDE" title="Cloud9 IDE">Cloud9 IDE</a></li></ul></li>
<li><a href="Atom_(text_editor)" title="Atom (text editor)">Atom</a></li>
<li><a href="CodeMirror" title="CodeMirror">CodeMirror</a>
<ul><li><a href="Brackets_(text_editor)" title="Brackets (text editor)">Brackets</a></li>
<li><a href="Light_Table_(software)" title="Light Table (software)">Light Table</a></li></ul></li>
<li><a href="PhpStorm" class="mw-redirect" title="PhpStorm">PhpStorm</a></li>
<li><a href="List_of_Eclipse_projects#Top-level_sub-projects" title="List of Eclipse projects">Orion</a></li>
<li><a href="Visual_Studio" title="Visual Studio">Visual Studio</a>
<ul><li><a href="Microsoft_Visual_Studio_Express" title="Microsoft Visual Studio Express">Visual Studio Express</a></li></ul></li>
<li><a href="Visual_Studio_Code" title="Visual Studio Code">Visual Studio Code</a></li>
<li><a href="Visual_Studio#Azure_DevOps_Services" title="Visual Studio">Visual Studio Team Services</a></li>
<li><a href="Vim_(text_editor)" title="Vim (text editor)">Vim</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%"><a href="JavaScript_engine" class="mw-redirect" title="JavaScript engine">Engines</a></th><td class="navbox-list-with-group navbox-list navbox-even hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="List_of_ECMAScript_engines" class="mw-redirect" title="List of ECMAScript engines">List of ECMAScript engines</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%"><a href="Software_framework" title="Software framework">Frameworks</a></th><td class="navbox-list-with-group navbox-list navbox-odd hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="Comparison_of_JavaScript-based_web_frameworks" title="Comparison of JavaScript-based web frameworks">Comparison of JavaScript frameworks</a></li>
<li><a href="List_of_JavaScript_libraries" title="List of JavaScript libraries">List of JavaScript libraries</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%">Related <a href="Technology" title="Technology">technologies</a></th><td class="navbox-list-with-group navbox-list navbox-even hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="Ajax_(programming)" title="Ajax (programming)">Ajax</a></li>
<li><a href="AssemblyScript" title="AssemblyScript">AssemblyScript</a></li>
<li><a href="Asm.js" title="Asm.js">asm.js</a></li>
<li><a href="Cascading_Style_Sheets" class="mw-redirect" title="Cascading Style Sheets">Cascading Style Sheets</a></li>
<li><a href="Document_Object_Model" title="Document Object Model">Document Object Model</a></li>
<li><a href="HTML" title="HTML">HTML</a>
<ul><li><a href="HTML5" title="HTML5">HTML5</a></li></ul></li>
<li><a href="JSON" title="JSON">JSON</a></li>
<li><a href="WebAssembly" title="WebAssembly">WebAssembly</a></li>
<li><a href="WebAuthn" title="WebAuthn">WebAuthn</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%"><a href="Package_manager" title="Package manager">Package managers</a></th><td class="navbox-list-with-group navbox-list navbox-odd hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="Npm" title="Npm">npm</a></li>
<li><a href="Pnpm" title="Pnpm">pnpm</a></li>
<li><a href="Yarn_(package_manager)" title="Yarn (package manager)">yarn</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%">Module bundlers</th><td class="navbox-list-with-group navbox-list navbox-even hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="Webpack" title="Webpack">Webpack</a></li>
<li><a href="Vite_(software)" title="Vite (software)">Vite</a></li>
<li><a href="Esbuild" title="Esbuild">esbuild</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%"><a href="Server-side_JavaScript" class="mw-redirect" title="Server-side JavaScript">Server-side</a></th><td class="navbox-list-with-group navbox-list navbox-odd hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="Active_Server_Pages" title="Active Server Pages">Active Server Pages</a></li>
<li><a href="Bun_(software)" title="Bun (software)">Bun</a></li>
<li><a href="CommonJS" title="CommonJS">CommonJS</a></li>
<li><a href="Deno_(software)" title="Deno (software)">Deno</a></li>
<li><a href="JSGI" title="JSGI">JSGI</a></li>
<li><a href="Node.js" title="Node.js">Node.js</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%"><a href="Unit_testing" title="Unit testing">Unit testing</a> frameworks (<a href="List_of_unit_testing_frameworks#JavaScript" title="List of unit testing frameworks">list</a>)</th><td class="navbox-list-with-group navbox-list navbox-even hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="Jasmine_(software)" title="Jasmine (software)">Jasmine</a></li>
<li><a href="Mocha_(JavaScript_framework)" title="Mocha (JavaScript framework)">Mocha</a></li>
<li><a href="QUnit" title="QUnit">QUnit</a></li></ul>
</div></td></tr><tr><th scope="row" class="navbox-group" style="width:1%">People</th><td class="navbox-list-with-group navbox-list navbox-odd hlist" style="width:100%;padding:0"><div style="padding:0 0.25em">
<ul><li><a href="Douglas_Crockford" title="Douglas Crockford">Douglas Crockford</a></li>
<li><a href="Ryan_Dahl" title="Ryan Dahl">Ryan Dahl</a></li>
<li><a href="Brendan_Eich" title="Brendan Eich">Brendan Eich</a></li>
<li><a href="John_Resig" title="John Resig">John Resig</a></li>
<li><a href="Jesse_James_Garrett" title="Jesse James Garrett">Jesse James Garrett</a></li></ul>
</div></td></tr></tbody></table></div></div><!--htdig_noindex--><div><div class="zim-footer">
This article is issued from <a class="external text" title="Last edited on 2025-07-14" href="https://en.wikipedia.org/wiki/?title=JavaScript_syntax&oldid=1300481067">Wikipedia</a>. The text is available under <a class="external text" href="https://creativecommons.org/licenses/by-sa/4.0/deed.en">Creative Commons Attribution-Share Alike 4.0</a> unless otherwise noted. Additional terms may apply for the media files.
</div>
</div><!--/htdig_noindex--></div>
</div>
</main>
</div>
</div>
</div>
</body></html>